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INTRODUCTION 


This manual is designed to assist the user with the diagnostic and utility 
programs that make up the Flagstaff Engineering Diskette Connection 
System. The Utilites/8 diskette contains the following files: 


DEVICE DRIVERS AND RELATED FILES: 


CONFIGD.SYS Configuration file for diskette controller card. 
CONFIGX.SYS Configuration file with sample DOS device 


parameters. 
FLAGIO.SYS Device driver for diskette and tape controller cards. 
FLAGX.SYS Device driver to allow use of external devices as 
DOS drives. 


FLAGINS.SYS __ Installs table entires for FLAGX.SYS 
INT13C.ASM 8088 assembler source file for device driver 
; access. — 
DEMO.C Source code in “C” for device driver access 
demonstration. 
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DIAGNOSTIC PROGRAMS: 


CHECK8 Check external drive read/write. 

VERIFY8 Check external drive operations. 

FILEGEN Build DOS test data file. 

IDs Display diskette sector ID’s. 

UTILITY PROGRAMS: 

CPY8TO5 Copy external diskette data to DOS files. 

CPY5TO8 Copy DOS files to external diskettes. 
~COPY8 | Duplicate 8" diskettes using a single drive. 

EDIT8 Display and edit external diskette sectors. 

DOSFMT8 Format external DOS diskettes. 

FMT8INS Installation of diskette format in DOSFMTS8. 

DCOPY Copy DOS file to smaller files. 

DFILE Display/edit DOS file records. 

ABOUT THIS MANUAL 


In the sections describing program operations, keyboard entries are 
indicated by key names or characters inside angle brackets: 


<ENTER> means the “ENTER” key; 

<Y> means the “Y” key; 

<01001> means the digits 0, 1, 0, 0, and 1. 
PROGRAM OPERATION 


The programs may be copied to and executed from any DOS diskette or 
hard disk volume desired. Programs are run by typing their names at the 
DOS system prompt: , 


A> <program name> 
Program prompts for key entries are issued by the programs inthe forms: 


(DEFAULT/RANGE OF ENTRIES) and 
(DEFAULT/OPTION1,OPTION2,OPTIONS) 
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At the prompt, “ENTER DRIVE NUMBER (1/2-4)?’, pressing the 
<ENTER:> key will select the default entry of “1”. Optional values may 
be entered by pressing <2>, <3>, or <4> followed by the <ENTER> key. 


EXTERNAL DEVICE TYPES 


The utility and diagnostic programs can access several types of external 
devices through the Flagstaff Engineering diskette controller card. The 
programs will prompt the user for the device type being used. External 
device types are indicated by a single alphanumeric character. Device 
types for diskettes and drives are: 


Table 1: External Device Types 


8: 8" diskette or drive. 

5: 5-1/4" 48 TPI 360K device or drive. 

Q: 5-1/4" 96 TPI 720k quad density. 

H: 5-1/4" 96 TPI 1.2 meg. high density. 

3: 3-1/2" 135 TPI 300 RPM drive. 
(3-1/2" Data General diskettes.) 


EXTERNAL DEVICE NUMBERS 


The utility and diagnostic programs access up to four (4) external 
diskette drives through the Flagstaff Engineering diskette controller 
card. The programs will prompt the user for the drive number being 
used. External drives are indicated by a single numeric character. 
External drive numbers are defined as: 


1: first external drive off rear of diskette 
controller card. 


2: second external drive off rear of diskette 
controller card. 


3: third external drive off front of diskette 
controller card. 


4: fourth external drive off front of diskette 
controller card. 
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ABOUT 8" DISKETTES AND WRITE PROTECTION 


For those users familiar with using 5-1/4" diskettes, the method of write- 
protecting 8" diskettes is exactly the opposite of what you’re used to. 
When using 8" diskettes, there must be a write-protect tab covering the 
notch in the side of the diskette in order to write to it. An 8"diskette is write- 
protected when there is notabover the notch. Most of the diagnostic and 
utility programs included in this package will issue an error message 
similar to this: 


DISKETTE WRITE PROTECTED 


if the program attempts to write to a protected diskette. Write-protection 
is irrelevant, of course, if the diskette is only being read (such as in 
CPY8TOS). 


DEVICE DRIVERS 


When you install external drives that are connected to the Flagstaff 
Engineering diskette controller card, you must also install a software 
module, called a device driver, that the operating system (DOS) uses to 
communicate with the disk drive(s). The device driver is in a file called 
FLAGIO.SYS on the distribution diskette. In order for your system to use 
this device driver, two conditions must be met: 


1. The device driver (FLAGIO.SYS) must be present inthe root directory 
of any volumes—diskettes or hard disks—that will be used to boot the 
system (the “boot volume” is the disk or diskette that is first read at 
system start-up time). Therefore, if you plan on using a number of 
diskettes to start the system from (in drive A:), then each diskette must 
contain FLAGIO.SYS in the root directory. 


2. A special file used by DOS called CONFIG.SYS must also be present 
in the root directory of any “boot volumes,” and it must contain a 
statement that identifies FLAGIO.SYS as a device driver to the system. 
This is an ASCII file that can be created or modified with any simple text 
editor, or can be created directly from the keyboard (see 

the section in the DOS reference manual on “Creating a Batch File’). If 
your system doesn't already have a CONFIG.SYS file, you can copy the 
file CONFIGD.SYS from the distribution diskette onto your bootable 
volumes, then rename the file CONFIG.SYS. CONFIGD.SYS uses the 
default parameters for the device driver, which are suitable for the 
majority of IBM PC/XT/AT systems. 
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THE CONFIG.SYS FILE 


This statement, identifying the device driver to the system, must be 
present in CONFIG.SYS: 


DEVICE=FLAGIO.SYS (D=2,6,3E8) 
(The space before the left parenthesis is required). 


This sets up the disk controller card with the default values. If these 
values work with your system, then you probably don’t need (or even 
want!) to know what they mean. However, if your machine is a “clone” 
(non-IBM), or if you have other cards or devices installed in your machine 
(such as acommunications adapter or a second printer), then there may 
be hardware or software conlicts that require changing these parame- 
ters. 


See Appendix A for a fuller, more technical explanation of the device 
driver parameters, or contact technical support at Flagstaff engineering 
for advice (602) 779-3341). 


The CONFIG.SYS file must also.contain a BUFFERS statement: | 


BUFFERS=x 


where x is a number equal to or greater than 4. Add this statement if it 
isn’t already in the file, or modify the existing one if needed. 


If you are already loading other device drivers in CONFIG.SYS, you 
may need to change the order of DEVICE statements for the system to 
operate correctly. The order of statements is the order in which the 
device drivers are actually loaded by DOS. If changing this doesn’t 
resolve a problem, refer to the discussion of driver parameters above. 
After CONFIG.SYS and FLAGIO.SYS are installed, you must reboot the 
system for the device driver to be installed (use the three-key <CTRL>- 
<ALT> <DEL> “soft” boot, or turn the machine off, then on again). 


If everything has been properly set up, a message should appear 
verifying that the Flagstaff Engineering diskette device driver has been 
loaded; this message should appear BEFORE the system time and date 
messages, if any. If this message doesn't display, either CONFIG.SYS+ 
or FLAGIO.SYS are incorrect or are not present on the root directory Cc 
the boot volume. 
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Note that the device driver, FLAGIO.SYS, makes the diskette controller 
card and the drives attached to it available to the system as an I/O device. 
It does NOT, however, let the system use these external drives as DOS 
devices. DOS will not be able to communicate to the drive, which means 
that you cannot use the DOS COPY or DIR commands on this drive, or 
run any applications that expect to use the drive as aDOS drive (e.g., D:). 
In order to make DOS recognize the drive as a DOS device, with a drive 
letter assigned to it, you must install a second device driver known as 
FLAGX.SYS. This file is also on your distribution diskette. | 


USING FLAGSTAFF ENGINEERING EXTERNAL DRIVES AS DOS 
DEVICES USING FLAGX.SYS 


The secondary device driver FLAGX.SYS defines external Flagstaff 
Engineering drives as legal DOS devices. You must use this driver if you 
need to use the DOSFMT8 program, other application programs or DOS 
commands, such as COPY, DELETE, DIR or TYPE, to access DOS 
diskettes in the external drives. 


FLAGX.SYS contains a table of diskette formats (maximum of 16). As 
assembled, this device driver contains NO entries in the format table. 
Entries are placed in the table using FLAGINS. When installed, each 
entry in the table must be given a name of from 1 to 8 characters. This 
name is then used on the command line in CONFIG.SYS to pass format 
information for a specific external drive to FLAGX.SYS. 


If only the name and device type are specified, then the device driver 
obtains the remaining parameters for the BPB from the boot record of a 
DOS diskette when it is read. This type of entry allows diskettes using 
different formats to be freely exchanged in the same diskette drive. For 
diskettes which do not have valid boot sectors, all the parameters must 
be filled in. In this case, the device driver will never attempt to read the 
boot sector from the diskette. 


INSTALLING PARAMETERS INTO FLAGX.SYS (FLAGINS): 
Run this program to add or modify the diskette type table in the device 


driver FLAGX.SYS. The location of external diskettes must be specified 
on the command line on CONFIG.SYS. 
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FLAGINS - Installing parameters into FLAGX.SYS 
The general form of the secondary device driver statement is: 
Device=FLAGX.SYS d=name [d=name] 


d = External drive number 1 to 4 
name = Format name a specified at install time with FLAGINS. 


The device driver parameters (d=name) create logical drives, each with 
a unique drive letter (such as D:); each logical drive associated with a 
physical device (the drive identified by "d"), and acertain type of diskette 
(name); and each logical device is assigned a drive letter in sequence 
by DOS, starting with the existing drives inthe system. If your system 
has two 5 1/4" drives (A: and B:) and a fixed disk (C:), the next logical drive 
assigned will be D:. Since the drive letters are assigned to logical, not 
necessarily physical, devices, you can associate more than one type of 
diskette with a physical drive. This can be confusing, so here's an 
example. 


The following CONFIG.SYS statement defines four (4) logical drives: 
DEVICE=FLAGX.SYS (1=IBM8SM, 1=8U, 3=QU, 4=HDU) 


The device names used on the command line were created in FLAGINS. 
In this example, IBM8SM is a defined format, single sided 8" DOS 
diskette (the boot sector of the diskette will be read by the device driver 
to define physical format). QU is an undefined, 5 1/4”, 96 TPI format. 
HDU is an undefined, 5 1/4" high density format. 


Assuming three (3) internal drives in the system (A:, B:, and C:), four (4) 
logical drives will be added--D:, E:, F: and G:. The drives will be set up 
as follows: 
Drive D: uses device number 1 (first physical drive off of 
external diskette controller card). "8SM", which indicates an 8", 
single sided, single density, DOS diskette. 


Drive E: uses device number 1 (first physical drive off of 
external diskette controller card). It is an 8" drive that will 
access any valid DOS formatted, 8" diskettes. 


Drive F: uses device number 3 (third physical drive off of 
external diskette controller card). It is a 96 TPI, 5 1/4" drive that 
will access any valid DOS formatted, 96 TPI, quad density 
diskette. 
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~~" 


Drive G: uses device number 4 (fourth physical drive off of 
external diskette controller card). Itis a48 TPI, 5 1/4" drive that 
will access any valid DOS formatted, 48 TPI, quad density 
diskette. 


PREDEFINED DISKETTE FORMATS 


FLAGX.SYS is supplied with the following predefined format names: 


Name Format 

IBM8LG 8" single sided, single density 
IBM8SM 8" double sided, double density: 
IBMHD 5 1/4" 96 TPI, 1.2 meg, high density 
IBM360 5 1/4" 48 TPI, 360k 

IBM3 3 1/2", 720k 

IBMQUAD 5 1/4" 96 TPI, 720k, quad density 
NEC8LG 8" NEC, 1024 byte sector 

8U 8” undefined 

HDU 5 1/4" high density, undefined 
QU 5 1/4" quad density, undefined 
5U 5 1/4" 48 TPl, undefined 

3U 3 1/2" , undefined 


Sample run: 
C> FLAGINS 
Enter device driver name to install: FLAGX.SYS 


FLAGSTAFF ENGINEERING 
DOS external device driver installation 


Entry name forloading a 
Diskette type (8/5/3/H/Q) b 


<BPB> <Physical> 
see above see above 
Bytes per sector Cc Density (s/d) k 
Secotors per allocation unit d Sides (1/2)) | 
Reserved sectors e First sector (0/1)m 
Number of fats f Sectors/track n 
Number of directory entries g 
Total sectors in media h 
Media descriptor t 
j Table entry number p 


Sectors per FAT 


Reply 
ESC=abort ENTER=Update record PgUp=Previous PgDn=Next End=Done 


Example screen: FLAGINS to install FLAGX.SYS 
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Using FLAGINS to install table entries in 
device driver FLAGX.SYS 


This installs actual table entries into FLAG.SYS, so the user should 
preserve a copy of FLAG.SYS before running this program. 


a. 


Name of entry. This is used on the command line in 
CONFIG.SYS to specify the type of driveformat attached to an 
external DOS diskette drive. 


The type of physical drive. 

8 = 8" drive 

5 = 5 1/4" single/double denisty (48 tracks/inch) 
3 =3 1/2" 720k 

H = 5 1/4" high density (96 tracks/inch, 1.2 meg) 
Q = 5 1/4" quad density (96 tracks/inch, 720k) 


To generate an entry which will access any DOS format found on adrive 
at execution time, enter ONLY the above two fields. To fully specify the 
format for faster diskette access or for formats which do not have a valid 
boot sector, also enter ALL of the following fields. 


Cc. 


d. 


Bytes/sector. Must be 128/256/512/1024 bytes. 


Sectors/allocation unit. The number of sectors allocated by 
each FAT table entry. 


Reserved sectors. The number of sectors preceeding the 
start of the first FAT table, which is usually one (the boot 
sector). 


Number of FATS. The number of times the FAT table is 
repeated on the diskette, which is normally two times. 


Number of directory entries. This determines the number of 
sectors allocated for the directory. 


Total sectors in the media. This includes the space occupied 
by the reserved sectors, the FATS, the directory and the data 
area. 


Media descriptor. This is a hex value. See DOS documen- 
tation for the usual values. This is largely ignored by DOS, 


except that the F9 value may cause problems if impoperly 


used. 
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]. Sectors/FAT. The number of sectors occupied by one FAT 
table. This is determined by the sectors/allocation unit and the 
total sectors in the media. 

k. Density. This must be 'S' for single, or 'D' for double density. 


l. Sides. This must be 1 for single, or 2 for double sided diskettes. 


m. First sector. This must be 0 or 1. This is the sector ID for the 
first sector on each track. Normally, this is set on 1. 


n. Sectors/track. This is the physical number of sectors on each 
track. 

p. This shows which table entry (relative to zero) in the device 
driver is being accessed. This is not intended for operator 
entry. 


When an entry has been entered/modified, press <ENTER> to update 
that table entry. Page up and down may be used to browse through the 
table entries. Any entry which is displayed may be altered and then 
updated by pressing <ENTER>. Press <END> to actually install the 
modified entires into the device driver. You may press <ESC> at any 
time to abort without updating. Note: the device driver is not actually 
updated, unless and until the <END> key is pressed. 
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Table 2: Drive Unit Numbers 


typical 
assignment 
0: 1st internal 5-1/4" drive — 
1: 2nd internal 5-1/4" drive a 
2: 1st external* drive 8"/5-1/4" 
3: 2nd external* drive 8"/5-1/4"/3-1/2" 
4: 3rd external” drive 8"/5-1/4°/3-1/2" 
5: 4th external* drive 3-1/2" high-density 


* external drive is defined by device select jumper on drive 


Drive select jumpers are as follows: 
External Drive(s) 
1 2 3 4 
8" driver DS1 DS2 DS3 DS4 
5-1/4" driver DSO DS1 DS2 DS3 


Table 3: Device / Media Type Numbers 


(see second table for media and format description) 


# diskette type 
0: 5-1/4" quad density, 96 TPI 
di; 3-1/2" Data General 
2: 5-1/4" standard 360K PC format, 48 TPI 
3: 5-1/4" PC/AT high density (1.2 megabyte) 
4: 8" standard DOS interchange NEC format 
5: 8" —see below 
6: 8" —see below 
7: 8" —see below 
8,9: currently undefined (for future use). 

disk media no. no. sector 
# size type cyls. files size 
0: 5-1/4" DSDD 80 112 512 
1: 3-1/2" DSDD 80 122 512 
2: 5-1/4" DSDD 40 112 512 
3: 5-1/4" DSDD 80 224 512 
4: 8" SSSD 77 68 128 
5: 8" DSDD 77 #72 256 
6: 8" DSDD 77 96 512 
7: 8" DSDD 77 336 512 
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The device driver parameters (d=t) create logical drives, each with a 
unique drive letter (such as D:). Each logical drive is associated with a 
physical device (the drive identified by “d”), and a certain type of diskette 
(“t"). Each logical device is assigned a drive letter in sequence by DOS, 
Starting with the existing drives in the system: if your system has two 5- 
1/4" drives (A: and B:) and a fixed disk (C:), the next logical drive 
assigned will be D:. Since the drive letters are assigned to logical, not 
necessarily physical, devices, you can associate more than.one type of 
diskette with a physical drive. This is confusing, so an example may help. 


The following CONFIG.SYS statement defines 4 logical drives: 
DEVICE=FLAGIOX.SYS (2=4,2=6,4=0,5=3) 


Assuming 3 internal drives in the system (A:, B: and C:), four logical 
drives will be added—D:, E:, F: and G:. The drives will be set up as 
follows: 


DRIVE D: uses device number 2 (1st external drive connected 
to Flagstaff Engineering Controller Card), and is an 8" drive 
using type four (4) disks (standard DOS interchange NEC 
format). 


DRIVE E: uses the same physical device as drive D: above, 
since the device number is the same, but it is a separate logical 
drive that reads and writes type 6 disks (8", 77 cyls., 96 files). 


DRIVE F: uses device number 4 (3rd external drive connected 
to Flagstaff Engineering Controller Card), and uses type 0 
disks (5-1/4" quad density or 3-1/2" Data General disks), 
depending on the physical drive type. 


DRIVE G: uses device number 5 (4th external drive connected 
to Flagstaff Engineering Controller Card), and uses type three 
(3) disks (5-1/4" high density). 


When setting up the configuration parameters, keep in mind that the 
device type must match the physical drive it is associated with. An 8" 
drive cannot have a type number that tries to make it look like a 3-1/2" 
or 5-1/4" drive. 


To format disks to use in external drives defined as DOS devices through 
FLAGIOX.SYS, you can use the DOSFMTS8 utility program. 
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DIAGNOSTIC PROGRAMS 


Diagnostic programs are included on the distribution diskette for use in 
verifying correct diskette operation and tracing diskette problems. 


To exit any diagnostic program while it is running, press <CTRL> <C>. 
On occasion, the Control-C sequence may not terminate the program. 
If this occurs, press <CTRL> <BREAKs to end the program. 


8" diagnostic programs include: 


CHECK8.EXE Check read/write operations of external diskette 


drives. 
FILEGEN.EXE Create DOS test files. 
ID8.EXE Display sector ID’s from external diskettes. 


VERIFY8.EXE Verify format of external diskettes and overall 
system operation. 


CHECK8.EXE 


CHECK8 checks 8" diskettes and verifies that they can be read from and 
written to properly. This program is used by Flagstaff Engineering to 
check and verify the operation of each external drive received from the 
factory. 


CHECK8 will verify read/write operations of the drive by configuring the 
diskette with various sector sizes in both single- and double-density 
formats. Data is written to the diskette and then read back using each 
format to verify operation. 


After the initial read/write test, the program will reformat the diskette as 
double-density with 512-byte sectors. This diskette format is generally 
the most difficult to write data to. If the program detects an error while 
formatting any track, the program will display a non-zero status code. 
The program will then try to reformat the track in question. The retry is 
usually successful. If the track formatting error still occurs after 5 retries, 
the program will issue a message to use a different blank diskette for the 
test. 


After formatting is complete, the program will read selected sectors on 
the diskette. The read operation will begin with cylinder 1, and the 
program will step forward 11 cylinders, reading a single sector from each 
cylinder. The program willthen step backward 5 cylinders, again reading 
a single sector from each cylinder. This pattern of stepping forward 11 
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cylinders, and then stepping backward 5. cylinders will be repeated until 
cylinder 76 is reached. 


After the read sequence is complete, the program will repeat the read 
test using a pattern of 9 forward steps and 4 backward steps. The read 
test will continue using patterns of 7 forward and 3 backward steps, 5 
forward and 2 backward steps, 3 forward and 1 backward steps, and 
finishwith 1 forward step and no backward steps. 


CHECKS should be run with a good quality double-sided, double-density 
diskette. The program will operate with a single-sided diskette but will 
only verify operation of head 0 on the diskette drive. 


CHECK8 will DESTROY ALL DATA on the test diskette in the external 
drive, so a blank diskette should be used with the program. 


RUNNING CHECK8 


Run CHECKS by typing its name at the DOS system prompt. After 
displaying a description message, the program will then prompt the user 
to enter a device type (see “External Device Types,” page1-2); enter 
<8>, <5>, <3>, <Q>, or <H> followed by <ENTERs> to indicate the 
devicetype being tested, or press <ENTER> only to select an 8" device. 
The program will prompt the user to insert a blank diskette into the drive 
and then select the drive number to be tested. 


Insert the diskette into the appropriate drive and then enter the drive 
number to be tested or press the <ENTER:> key to select drive 1. The 
program will then begin testing the drive. 


After the drive has been tested, the program will prompt the user to 
repeat or end the test. Select the appropriate option by entering <Y> 
or <N>, or end the program by pressing the <ENTER> key. 


The number of temporary read errors displayed when running this 
program should not be greater than 2. It’s possible that a few temporary 
errors might occur while running CHECKS8 due simply to the quality of the 
diskette used. If any permanent errors occur, you should rerun the 
program with the same diskette to see if the errors occur at the same 
location. If the errors occur at the same location, it is likely that the 
diskette has a bad spot on its surface. Use a different diskette and rerun 
the program to verify correct operation of the drive. 
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DEFAULTS: 
Default entries for program prompts are: 


Drive number: <ENTER> means drive 1. 
Repeat Test: <ENTER> means End. | 


DESTRUCTIVE/NONDESTRUCTIVE: 


CHECK8 WILL DESTROY ALL DATA ON THE TEST DISKETTE. 


SAMPLE RUN OF CHECKS: 


A>CHECK8 <enter> 


8" DISKETTE SYSTEM DIAGNOSTIC PROGRAM 
COPYRIGHT FLAGSTAFF ENGINEERING 5/10/83 


DO YOU WANT TO USE AN 8°,5",3 1/2, 5"-QD,OR 5"HD DRIVE (8/5,3,Q,H) 
<enter> 


INSERT BLANK 8" DISKETTE - 
ENTER DRIVE (1/2-4) WHEN READY.? <enter> 


TEST 01 - VERIFY CARD AND CABLE OK 

TEST 02 - FORMAT 128 BYTE SINGLE DENSITY 
VERIFY 8" CYL=10 HEAD=0 SECTOR=01 

GOOD OPERATION 

TEST 02 - FORMAT 128 BYTE SINGLE DENSITY 
VERIFY 8" CYL=10 HEAD=1 SECTOR=01 

GOOD OPERATION 

TEST 03 - FORMAT 256 BYTE SINGLE DENSITY 
VERIFY 8° CYL=10 HEAD=0 SECTOR=01 

GOOD OPERATION 

TEST 03 - FORMAT 256 BYTE SINGLE DENSITY 
VERIFY 8" CYL=10 HEAD=1 SECTOR=01 

GOOD OPERATION 

TEST 04 - FORMAT 512 BYTE SINGLE DENSITY 
VERIFY 8° CYL=10 HEAD=0 SECTOR=01 

GOOD OPERATION 

TEST 04 - FORMAT 512 BYTE SINGLE DENSITY 
VERIFY 8" CYL=10 HEAD=1 SECTOR=01 

GOOD OPERATION 

TEST 05 - FORMAT 1024 BYTE SINGLE DENSITY 
VERIFY 8" CYL=10 HEAD=0 SECTOR=01 

GOOD OPERATION 

TEST 05 - FORMAT 1024 BYTE SINGLE DENSITY 
VERIFY 8" CYL=10 HEAD=1 SECTOR=01 

GOOD OPERATION 
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TEST 06 - FORMAT 256 BYTE DOUBLE DENSITY 
VERIFY 8" CYL=10 HEAD=0 SECTOR=01 

GOOD OPERATION 

TEST 06 - FORMAT 256 BYTE DOUBLE DENSITY 
VERIFY 8" CYL=10 HEAD=1 SECTOR=01 

GOOD OPERATION 

TEST 07 - FORMAT 512 BYTE DOUBLE DENSITY 
VERIFY 8" CYL=10 HEAD=0 SECTOR=01 

GOOD OPERATION 

TEST 07 - FORMAT 512 BYTE DOUBLE DENSITY 
VERIFY 8" CYL=10 HEAD=1 SECTOR=01 

GOOD OPERATION 

TEST 08 - FORMAT 1024 BYTE DOUBLE DENSITY 
VERIFY 8" CYL=10 HEAD=0 SECTOR=01 

GOOD OPERATION 

TEST 08 - FORMAT 1024 BYTE DOUBLE DENSITY 
VERIFY 8" CYL=10 HEAD=1 SECTOR=01 

GOOD OPERATION 

TEST 09 - FORMAT 2048 BYTE DOUBLE DENSITY 
VERIFY 8" CYL=10 HEAD=0 SECTOR=01 

GOOD OPERATION 

TEST 09 - FORMAT 2048 BYTE DOUBLE DENSITY 
VERIFY 8" CYL=10 HEAD=1 SECTOR=01 

GOOD OPERATION 

TEST 10 - FORMAT ENTIRE DISKETTE 

TO 512 BYTE SECTORS 

WRITING 8° CYL=XX HEAD=X SECTOR=XX 
GOOD OPERATION 

READING 8" CYL=XX HEAD=X SECTOR=X 

GOOD OPERATION 

DISKETTE DIAGNOSTIC IS COMPLETED - 

00 TEMPORARY READ ERRORS 


DO YOU WANT TO REPEAT TESTS (N/Y)? <enter> 
A> 


FILEGEN.EXE 


USE: Create test DOS file. 


NOTES: FILEGEN.EXE is supplied on the distribution diskette as an aid 
to defining possible problems in transfer and conversion programs. A 
DOS test file created by FILEGEN can be transferred to an external 
diskette, and then transferred back to aDOS volume. The original file 
may then be compared with the transferred copy to insure data has not 
been added or lost. 
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DESCRIPTION: FILEGEN.EXE is designed to create a DOS test file for 
diagnostic use. The program creates sequential fixed length records 
containing five byte fixed fields. The five byte fields contain a 5-digit 
record number. The first record of the file has fields containing the 
characters 00001. The second record contains fields with the characters 
00002, etc. 


Records lengths may be from 1 to 4096 bytes. Up to 60,000 records may 
be created. Records may created as either ASCII or EBCDIC data. 
Carriage return/line feed pairs may be added to the end of each record. 


RUNNING FILEGEN 


Run FILEGEN by typing its name at the DOS system prompt. After 
displaying a program description message, the program willthen prompt 
the user to enter a DOS file name for the test data. Enter aDOS file name 
and press <ENTER>. The program will prompt the user to enter the 
number of test data records to create. 


Enter a number from 1 to 60,000 (do not include any commas), or press 
<ENTER:> to select 100 test records. The program will then prompt the 
user to enter the record size in bytes. 


Enter a number from 1 to 4096, or press <ENTER:> to select 128-byte 
records. The program will ask whether the user wants to add acarriage- 
return/line feed pair to the end of each record. 


Enter <Y> to add a CR/LF, or press <ENTER> to create records without 
CR/LFs. The program will ask whether the user wants EBCDIC or ASCII 
data. 7 


Enter <E> to select EBCDIC data, or press <ENTER> to select ASCII 
data. The program will generate a file using the input parameters, and 
then display a message indicating the number of records created. The 
program will then ask if the user wants to create another file. Enter a 
DOS file name to create another test file, or press <ENTER> to end the 
program. 


DEFAULTS: 

File name: <ENTER> means Exit program. 
Number of records: <ENTER> means 100 

Record size: <ENTER> means 128 

CR/LF in record: <ENTER> means No 

ASCIil or EBCDIC: <ENTER> means ASCII 
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SAMPLE RUN OF FILEGEN: 


A>FILEGEN <enter> 


GENERATE TEST DATA FILE PROGRAM 
COPYRIGHT FLAGSTAFF ENGINEERING 9/6/85 


ENTER DOS FILE NAME FOR TEST DATA - PRESS ENTER FOR NONE? 
datatest.dat <enter> 


ENTER NUMBER OF TEST DATA RECORDS (100/1-60000)? <enter> 
ENTER RECORD SIZE IN BYTES (128/1-4096)? <96> <enter> 


DO YOU WANT A CR-LF AT THE END OF EACH DATA RECORD (N/Y)? 
<enter> 


DO YOU WANT DATA IN ASCII OR EBCDIC (A/E)?  <enter> 


CREATION OF DATATEST.DAT IS COMPLETED - 
100 RECORDS WERE CREATED 


ENTER DOS FILE NAME FOR TEST DATA -PRESS ENTER FOR NONE? 
<enter> 
A> 


ID8.EXE 
USE: Display sector IDs on external 8” diskettes. 


NOTES: ID8.EXE is supplied on the distribution diskette as an aid to 
determining nonstandard diskette formats. The program would normally 
be used during over-the-phone technical assistance. 


DESCRIPTION: ID8.EXE is designed to find and display sector ID 
numbers on external diskettes. The program is used by Flagstaff 
Engineering to determine the formatting of nonstandard diskettes. The 
program is not designed as a standard diagnostic, and-should only be 
run at the request of Flagstaff Engineering technical support staff. 


RUNNING ID8 
Run ID8 by typing its name at the DOS system prompt. After a program 


description message is displayed, the program willthen promptthe user 
to enter a device type (see “External Device Types,” page 1-3). 
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Enter <8>, <5>, <3>, <Q>, or <H> followed by <ENTER:> to indicate 
device type being tested, or press <ENTER> only to select an 8" device. 


The program will then prompt the user to insert a diskette into the drive, 
and enter the drive number in use. 


Insert the diskette into the appropriate drive and then enter the drive 
number to be tested or press <ENTERs> only to select drive 1. The 
program will prompt the user for the format of the diskette being read. 
Enter a number from 0 to 7 to indicate one of the following formats: 


Table 4: 8" Diskette Formats 


0 = 128 FM 4 = 256 MFM 
1 = 256 FM 5 = 512 MFM 
2=512 FM 6 = 1024 MFM 
3 = 1024 FM 7 = 2048 MFM 


NOTE: for the purposes of this table, “FM” and “MFM” have the following 
meanings: 

FM = _ single-density diskette 

MFM = double-density diskette. 


The program will prompt the user to enter the cylinder and head to be 
identified. Enter the cylinder and head as CCH, where “CC’ is 0 through 
79, and “H” is either 0 or 1. 


The program will then attempt to read the cylinder selected. If the sector 
IDs can be read, the program will display 16 lines of status codes. These 
Status codes can be used to determine the physical format of the 
diskette. The status codes for two consecutive sectors appear on each 
status line. Status line are in the following format: 


S0S1 S2CC HHRR NNOO.. SOS1 S2CC HHRR NNoo 


SO = status byte 0 of NEC controller chip. 

$1 = status byte 1 of NEC controller chip. 

S2 = status byte 2 of NEC controller chip. 

CC = cylinder number. 

HH = head number. 

RR = sector number (sector ID). 

NN = sector size byte: 0 = 128 bytes 
1 = 256 bytes 
2 = 512 bytes 
3 = 1024 bytes 
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SAMPLE RUN OF ID8: 


A>id8 


DISKETTE SYSTEM READ SECTOR ID PROGRAM 
COPYRIGHT FLAGSTAFF ENGINEERING XX/XX/XX 


THIS PROGRAM WILL READ AND DISPLAY ALL THE SECTOR ID ON A 
SPECIFIED DISKETTE TRACK. 


DO YOU WANT TOTEST AN 8", 5", 3 1/2, 5"-QD, OR 5°-HD DRIVE (8/5,3,Q,H)? 
<enter> 


INSERT 8° DISKETTE - ENTER DRIVE (1/2-4) WHEN READY? <enter> 


ENTER DISKETTE FORMAT (0=128FM, 3=1024FM, 4=256MFM, 
7=2048MFM)? <5> <enter> 


ENTER CYLINDERAND HEAD FOR READ SECTORID (CCH)? <010><enter> 


READING CYL=01 HEAD=0 SECTOR=01 
GOOD OPERATION 


SOS1 S2CC HHRR NN 

0100 0001 0001 0200 0000 0000 
0100 0001 0002 0200 0000 0000 
0100 0001 0003 0200 0000 0000 
0100 0001 0004 0200 0000 0000 


0100 0001 OOOE 0200 0000 0000 
0100 0001 OOOF 0200 0000 0000 
0100 0001 0001 0200 0000 0000 
0100 0001 0002 0200 0000 0000 


DO YOU WANT TO REPEAT THESE TESTS (N/Y)? <enter> 
A> 


VERIFY8.EXE 


USE: Verify format and and sector size of external diskettes. Verify read 
operations of external drive(s) and confirm correct head alignment. 


DESCRIPTION: VERIFY8 displays the format and sector size of a 
formatted diskette, and identifies possible head alignment problems with 
external diskette drives. VERIFY8 does a good job of finding even 
marginal drive problems. 
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The program first examines cylinder 5 to determine the diskette format- 
ting. After the format is identified and displayed, the program will 
measure the drive rotation speed and display the speed measurement 
in milliseconds. Normally, drive rotation speed is 166.7 milliseconds for 
5 1/4" HD and 8" 360 RPM drives. 200 ms is normal for 300 RPM 3-1/ 
2" and 5-1/4" quad density drives. 100.0 msis normalfor3-1/2" 600 RPM 
drives. 


_ The program will then perform aseek test to step the diskette drive heads 
forward and backward through all sectors on the diskette. The program 
will begin the seek test by reading cylinder 1, and then will step forward 
7 cylinders, reading a single sector from each cylinder. The program will 
then step backward 3 cylinders, again reading a single sector from each 
cylinder. The pattern of stepping forward 7 cylinders, and then stepping 
backward 3 cylinders will be repeated until Cylinder 76 is reached. After 
this read sequence is complete, the program will repeat the read 
operation using a pattern of 5 forward steps and 2 backward steps, then 
3 forward and 1 backward steps, and end with 1 forward step and no 
backward steps. The number of temporary read errors should be zero 
on a good diskette. 


After the seek test has been completed, the program will perform a read 
test which reads a complete track. The number of read errors should 
again be zero. 


The program will then perform a track loop test to verify head alignment. 
Cylinder 70, head 0, sector 1 will be read 100 times. The number of 
temporary read errors should be zero. 7 


VERIFY8 may be run with any formatted high-quality double sided 
diskette. The program will operate with a single sided diskette but will 
only verify operation of head 0 on the diskette drive. 


VERIFY8 will not destroy data on the test diskette in the 8 inch drive. 


RUNNING VERIFY8 


Run VERIFY8 by typing its name at the DOS system prompt. After 
displaying a program description message, the program willthen prompt 
the user to enter a device type (see “External Device Types,” page 1- 
3). Enter <8>, <5>, <3>, <Q>, or <H> followed by <ENTER:> to indicate 
the device type being tested, or press <ENTER:> by itself to select an 8" 
device. The program will prompt the user to insert a blank diskette into 
the drive and then select the drive number to be tested. 
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Insert the diskette into the appropriate drive and then enter the drive 
number to be tested or press <ENTER> only to select drive 1. The 
program will then begin testing the drive. After completing the test, the 
program will prompt the user to repeat the test or end the program. 
Select the appropriate option by entering <Y> or <N>, or end the 
program by pressing the <ENTER> key only. 


It is possible that a few temporary errors will occur while running 
VERIFY8 depending to the quality of the diskette used. If any permanent 
errors occur, you should rerun the program with the same diskette to see 
if the errors occur at the same location. If they do, it is likely that the 
diskette has a bad spot on its surface. Use a different diskette and rerun 
the program to verify correct operation of the drive. 


DEFAULTS: 
Default entries for program prompts are: 
Device Type: <ENTER> means 8". 


Drive number: <ENTER> key means drive 1. 
Repeat Test: <ENTER> key means No. 


DESTRUCTIVE/NONDESTRUCTIVE: 
VERIFY8 will not destroy data on the test diskette. 
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SAMPLE RUN OF VERIFY8: 


A>VERIFY8 <enter> 


DISKETTE SYSTEM VERIFY PROGRAM 
COPYRIGHT FLAGSTAFF ENGINEERING 3/15/85 


DO YOU WANT TO TEST AN 8°,5",3 1/2”,5"-QD, OR 5°-HD DRIVE (8/5,3,Q,H)? 
<enter> 


INSERT 8" DISKETTE - 
ENTER DRIVE (1/2) WHEN READY.? <enter> 


READING 8" CYL=XX HEAD=X SECTOR=XX 
GOOD OPERATION 


TEST 01 - DISKETTE IS 128 BYTE SECTOR -SINGLE DENSITY-SINGLE SIDE 


TEST 02 - DRIVE ROTATION SPEED IS 165.8 MSEC. (NORMAL=166.7 OR 
200.0 MSEC.) 


TEST 03 - SEEK TEST STARTED 

READING 8" CYL=76 HEAD=0 

SECTOR=13 GOOD OPERATION 

TEST 03 - SEEK TEST COMPLETED - on 
57.72 SECONDS - 00 TEMPORARY READ ERRORS | | 


TEST 04 - READ DATA TRACK STARTED 
READING 8" CYL=76 HEAD=0 

SECTOR=01 GOOD OPERATION 

TEST 04 - READ DATA TRACK COMPLETED - 
00 TEMPORARY READ ERRORS 


TEST 05 - TRACK LOOP STARTED 

READING 8° CYL=70 HEAD = 0 

SECTOR=01 GOOD OPERATION XXX 

TEST 05 - TRACK LOOP COMPLETED - 

00 TEMPORARY READ ERRORS 

DO YOU WANT TO REPEAT TESTS (N/Y)?  <enter> 


A> 
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UTILITY PROGRAMS 


Utility programs are included on the distribution diskette for use in 
formatting, displaying, and copying data between DOS files and external 
diskettes. A single-drive 8” diskette copy program is also provided. 


To exit any utility program while it is running, press <CTRL> <C>. On 
occasion, the Control C sequence may not terminate the program. Ifthis 
occurs, press <CTRL> <BREAK> to end the program. 


~The utility programs include: 


CPY8TO5.EXE Copy external diskette sectors to DOS file. 

CPY5TO8.EXE Copy data from DOS files to sectors on an external 
diskette. 

COPY8.COM Duplicate an 8" master diskette using a single 8" 
drive system. 

EDIT8.EXE Display and modify data on specific sectors of an 
external diskette. 

DOSFMT8.EXE Format a DOS compatible external diskette. 


CPY8TO5.EXE 


This program copies specific sectors from an external diskette to a DOS 
file. 


CPY8TOS is designed to copy sectors from an external diskette with an 
erased or invalid file directory, in order to recover damaged files. The 
program copies the sectors onto a DOS file on a diskette or hard disk. 
This program should only be used with non-DOS external diskettes or 
those with an erased or damaged file directory. To copy DOS files on 
or between DOS diskettes, use the standard DOS COPY command. 


Sectors from the external diskette may be copied to a DOS file on any 
drive, including a hard disk drive. Data can be copied from the source 
diskette to the destination file exactly as read, or EBCDIC-to-ASCIl 
translation can be performed if needed. Most 8" IBM-format diskettes 
are recorded in EBCDIC, while DOS files on the PC are in ASCII. 


The program will identify the format of the external diskette to be copied 
from and display the format. The sector size of the external diskette will 
then be used for the size of the records written to the DOS file. 
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The data area to copy from the external diskette is defined by a starting 
and ending location in terms of diskette sectors. The starting and ending 
location of the data area to be copied is specified as CCHSS, where “CC” 
is a 2-digit cylinder number from 00 through 79, “H” is a 1-digit head. 
number (either 0 or 1), and “SS” is a 2-digit sector number from 01 
through 26, depending on the specific format of the diskette. The 
following table shows the range of possible values for various diskette 
formats. 


Table 5: SECTOR NUMBER RANGES FOR 
VARIOUS DISKETTE FORMATS 


sector # 
diskette formats range 
128-byte sector, single density/ 1-26 
256-byte sector, double density 
256-byte sector, single density/ 1-15 
512-byte sector, double density 
512-byte sector, single density/ 1-8 
1024-byte sector, double density 
1024-byte sector, single density/ 1-4 


2048-byte sector, double density 


CPY8TOS5 also allows the selection of certain physical disk format 
parameters to allow sectors to be read from nonstandard diskettes. 
Both the number of sectors per track and the inter-sector gap size can 
be changed. For moststandard diskettes (such as IBM Diskette 1 
andDiskette 2), the default values should be selected by pressing 
<ENTER> when these prompts appear. Since this is a fairly technical 
area, further discussion and tables appear at the end of this section. 


RUNNING CPY8TO5 


Run CPY8TOS by typing its name at the DOS system prompt. After 
displaying a program identification message, the program will prompt 
the user to enter a device type (see “External Device Types”, p. 1-3). 


Enter <8>, <5>, <3>, <Q>, or <H>, followed by <ENTER:> to indicate the 
device type being tested, or press <ENTER> only to select an 8" device. 
The program will then prompt the user to insert a diskette into the drive, 
and enter the drive number in use. 
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Insert the diskette into the appropriate drive, then enter the drive number 
to be tested or press the <ENTER> key to select drive 1. 


An EBCDIC-to-ASCIlI prompt will be displayed. 


Enter <Y> to select EBCDIC-to-ASCIl conversion. Enter <N> or press 
the <ENTER> key to copy the data “as is,” with no conversion. 


The program then prompts the user to enter the starting cylinder, head, 
and sector number for the data area on the external diskette that will 
copied to a DOS file. The entry format is CCHSS as explained above. 


Enter the cylinder, head, and sector number as a 5-digit number with no 
blanks between the digits. If the <ENTER> key is pressed without 
entering the CCHSS, the program will end the copy operation. 


The program will then prompt the user to enter the ending cylinder, head 
and sector number (CCHSS) of the data area to be copied. 


Enter the cylinder, head, and sector number as a 5-digit number with no 
blanks between the digits. If the <ENTER> key is pressed without 
entering the CCHSS, the program will reprompt the user for CCHSS. 


The program will read the first copy sector and display a format 
information line with bytes per sector, single or double density, and 
single or double sided. 


If the external diskette format cannot be identified, the program will 
display an “unknown format” message and end the copy operation. 


After the sector and format information lines are displayed, the program 
will prompt the user to enter the “sector number origin”: this isthe number 
of the lowest-numbered sector on the diskette. Normally, sector 1 isthe 
first sector on each track; however, certain diskettes start with sector 0, 
and this option is provided to allow these diskettes to be read. If there is 
any question about which is the case for a diskette, we recommend that 
you run the diagnostic program ID8.EXE to discover the sector number 
origin. To select the default value, just press <ENTER>. 


The next two prompts ask for the number of sectors per track and the 
sector gap size. As mentioned above, the default values given for these 
choices are correct for the majority of diskettes, and should only be 
changed when nonstandard diskette formats are being read. Refer to 
the end of this section for a more complete discussion of these parame- 
ters, or press <ENTER:> to choose the default values. 
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Next, the program will ask forthe name ofthe DOS file where the diskette 
data will be written. Enter filename with any necessary qualifiers (such 
as drive letter or path names). If <ENTER> is pressed without entering 
any filename, the program will end the copy operation. If the given file 
already exists, the program will notify you of this and ask you if you want 
to erase this file: if you type “Y” or press <ENTER3 only at this point, the 
file will be overwritten, meaning that any existing data in the file will be 
destroyed. If you don’t want the file to be overwrittem, enter "N”, then 
press <ENTER>. 


After the output filename has been entered, the program will begin the 
copy operation. As sectors are read from the 8" diskette, a “reading” 
message will be displayed and updated to indicate that the copy is in 
progress. On completion of the copy operation, a message will be 
displayed indicating the total number of records (sectors) copied to the 
DOS file. The user will then be prompted to enter a starting CCHSS 
number for another copy operation. 


Enter a new starting CCHSS, or press <ENTER> only to exit the copy 
operation. 


The program will ask whether the user wants to copy from another 
diskette. Enter <Y> to continue, or press <N> or <ENTER3> to end the 
program. 


DEFAULTS: 

Device Type: | <ENTER> means 8" diskette. 

Drive number: <ENTER> means drive 1 

Starting CCHSS: <ENTER> means exit CCHSS prompt. 
Ending CCHSS: <ENTER> means reprompt for CCHSS. 
DOS File: <ENTER> means stop copy operation. 
EBCDIC to ASCII <ENTER> means No. 

Another Copy <ENTER> means No. 


DESTRUCTIVE/NONDESTRUCTIVE: 
CPY8TOS will not destroy data on the external source diskette. 


However, ALL EXISTING DATA IN THE DOS DESTINATION FILE 
WILL BE DESTROYED BY THE COPY OPERATION. 


Utility/8 Utilities 4-4 


SAMPLE RUN: 


A>CPY8TO5 <enter> 


COPY DISKETTE SECTORS TO DOS FILE PROGRAM 
COPYRIGHT FLAGSTAFF ENGINEERING 2/6/86 


THIS PROGRAM WILL COPY DATA SECTORS FROM A SPECIFIED LOCA- 
TION ONA DISKETTE TOA DOS FILE. THE USER CAN SPECIFY STARTING 
AND ENDING EXTENTS FOR THE COPY. AS A USER OPTION, THE 
PROGRAM CAN TRANSLATE THE DATA FROM EBCDIC TO ASCII DURING 
THE COPY. THE PROGRAM WILL AUTOMATICALLY IDENTIFY THE DISK- 
ETTE FORMAT. 


NORMAL CYLINDER VALUES (CC) ARE 00-79 FOR 8" AND 00-39 FOR 5° 
NORMAL HEAD VALUES (H) ARE 0 OR 1 NORMAL SECTOR VALUES (SS) 
FOR 8" ARE 1-26 FOR 128-SD AND 256-DD 

1-15 FOR 256-SD AND 512-DD 

1-8 FOR 512-SD AND 1024-DD 

1-4 FOR 1024-SD AND 2048-DD 
NORMAL SECTOR VALUES (SS) FOR 5" ARE | 

1-18 FOR 128-SD AND 256-DD 

1-9 FOR 256-SD AND 512-DD 

1-4 FOR 512-SD AND 1024-DD 

1-2 FOR 1024-SD AND 2048-DD 


ENTER DISKETTE TYPE (8"=DEFAULT/5=5",3=3 1/2",Q=5"-QD,H=5"-HD)? 
<enter> 

INSERT 8" DISKETTE - ENTER DRIVE (1/2-4) WHEN READY? <enter> 

DO YOU WANT EBCDIC TO ASCII CONVERSION (N/Y)? y 

ENTER STARTING CYLINDER, HEAD, AND SECTOR (CCHSS)? 01001 
ENTER ENDING CYLINDER, HEAD, AND SECTOR (CCHSS)? 04015 
DISKETTE IS 512 BYTE/SECTOR - DOUBLE DENSITY - DOUBLE SIDE 
ENTER SECTOR NUMBER ORIGIN (1=DEFAULT/0-1)? <enter> 

ENTER NUMBER OF SECTORS/TRACK (15=DEFAULT/4-32)? <enter> 
ENTER SECTOR GAP SIZE (027=DEFAULT/0-255)? <enter> 

ENTERDOS FILE NAME FOR COPY (A:\PATH\NAME.EXT)? \temp\8dump.asc 
READING CYL=01 HEAD=0 SECTOR=01 GOOD OPERATION 

READING CYL=01 HEAD=1 SECTOR=01 GOOD OPERATION 

READING CYL=02 HEAD=0 SECTOR=01 GOOD OPERATION 
READING.CYL=02 HEAD=1 SECTOR=01 GOOD OPERATION 

READING CYL=03 HEAD=0 SECTOR=01 GOOD OPERATION 

READING CYL=03 HEAD=1 SECTOR=01 GOOD OPERATION 

READING CYL=04 HEAD=0 SECTOR=01 GOOD OPERATION 

END OF COPY - 0105 RECORDS WERE COPIED 

ENTER STARTING CYLINDER, HEAD, AND SECTOR (CCHSS)? <enter> 


DO YOU WANT TO COPY FROM ANOTHER DISKETTE (N/Y)? <enter> 
A> 
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SELECTING DISKETTE PARAMETERS FOR 
NON-STANDARD DISKETTE FORMATS 


There are three (3) diskette parameters that can be changed in order to 
read non-standard diskette formats: 


1) sector number origin 
2) - number of sectors/track 
3) inter-sector gap size. 


Sector number origin is the sector ID number of the lowest-numbered 
sector on each track of the diskette. Possible choices are “0” or “1”, with 
1” as the default. Certain diskettes are known to have sector "0”"—CPM 
diskettes, for example. If this value is unknown, run the diagnostic 
program ID8.EXE to display the diskette sector IDs. 


Number of sectors/track is normally tied to the diskette format. These 
standard values are given in Table 5 above. This option allows formats 
tobe read that use from 4 to 32 sectors per track. Again, if the diskette 
format is unknown, ID8.EXE will tell you how many sectors each track 
contains, by displaying each sector ID on a track. 


Inter-sector gap size is set by default to the correct value for 512-byte/ 
sector, single- or double-density standard IBM diskettes. If other types 
of standard IBM diskettes are used, then the values from the following 
table should be used for this parameter. (If the diskette is anonstandard, 
non-IBM disk, then you’re pretty much on your own so far as valid sector 
gap size goes!) The values are numbers of bytes in the inter-sector gap: 


Table 6: Inter-Sector Gap Size Values 


diskette type sector gap size 
128 byte/sector single density 7 
256 byte/sector “ ‘ 14 
512 byte/sector “ r 27 
256 byte/sector double density 14 
512 byte/sector “ ‘ 27 
1024 byte/sector “ 53 
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CPY5TO8.EXE 


CPY5TO8.EXE is designed to copy DOS files to specific sectors of an 
external diskette with an erased or invalid file directory. When using 
_ CPYSTO8&, the target diskette (the one being copied to) should be only: 


1) anon-DOS external diskette, or 
2) a DOS-formatted diskette with an erased or 
damaged file directory. 


To copy files on or between normal DOS diskettes, use the standard 
DOS COPY command. 


The program will identify the format of the external diskette to be copied 
to and display the format. The sector size of the external diskette will 
then be used for the size of the records copied from the DOS file. Ifthe 
external diskette format cannot be recognized, the program will display 
an error message and end the copy operation. 


The DOS file will be copied to a specific area (defined as sectors) of the 
external diskette. The user must enter a starting location for the data 
area on the external diskette that will receive the copiedfile. The starting 
location is given as CCHSS, where “CC” is a 2-digit cylinder number from 
00 through 79, “H” is a 1-digit head number from 0 through 1, and “SS” 
is a 2-digit sector number from 01 through 26 (the range of possible 
sector numbers depends on the formatof the diskette: see Table 5 above 
for valid ranges). 


Data may becopied from a DOS file on any drive onthe system, including 
a hard disk drive. 


Data may be copied from a DOS file on any drive, including a hard disk 
drive. Data can be copied from the source file to the destination diskette 
exactly as read, or ASCII-to-EBCDIC translation can be performed if 
needed. Most 8” IBM-format diskettes are recorded in EBCDIC, while 
DOS files on the PC are in ASCII. 


The ASCIl-to-EBCDIC conversion translates an ASCII character to its 


EBCDIC equivalent, but no provision is made to exclude fields that 
contain binary or packed decimal numbers. 
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RUNNING CPY5TO8 


Run CPY5TO8 by typing its name at the DOS system prompt. After 
displaying a program description message, the program willthen prompt 
the user to enter a device type (see “External Device Types,” page 1-2). 


Enter <8>, <5>, <3>, <Q>, or <H> followed by <ENTER:> to indicate 
device type being tested, or press <ENTER> only to select an 8" device. 


The program will then prompt the user to insert a diskette into the drive, 
and to enter the drive number in use. 


Insert the diskette into the appropriate drive and then enter the drive 
number to be tested, or press the <ENTER> key to select drive 1. 


An ASCIl-to-EBCDIC prompt will be displayed. 


Enter <Y> to select ASCIl-to-EBCDIC conversion. Enter <N> or press 
<ENTER> only to copy the data “as is.” 


The program then prompts the user to enter the Starting cylinder, head, 
and sector number for the data area on the external diskette that will 
receive the copy data. The entry format is “CCHSS” as explained above 
for the CPY8TOS5 program. 


Enter the cylinder, head, and sector number as a 5-digit number with no 
blanks between the digits. If the <ENTER> key is pressed without 
entering CCHSS, the program will end the copy operation. 


The program will read the first copy sector of the external diskette and 
display a format information line with bytes per sector, single or double 
density, and single or double sided. If the external diskette format cannot - 
be identified, the program willdisplay an “unknown format” message and 
the end the copy operation. 


After the sector and format information lines are displayed, the program 
will prompt the user to enter the “sector number origin”: this is the 
number of the lowest-numbered sector on the diskette. Normally, sector 
1 is the first sector on each track; however, certain diskettes start with 
sector 0, and this option is provided to allow these diskettes to be read. 
If there is any question about which is the case for a diskette, we at 
Flagstaff Engineering recommend that you run the diagnostic program 
ID8.EXE to discover the sector number origin. To select the default 
value, just press <ENTER>. 
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The next two prompts ask for the number of sectors per track and the 
sector gap size. As mentioned above, the default values given for these 
choices are correct for the majority of diskettes, and should only be 
changed when nonstandard diskette formats are being read. Refer to 
the end of the section on CPY8TOS5 in this manual for a more complete 
discussion of these parameters, or press <ENTER> to choose the 
default values. 


Next, the program will ask for the name of the DOS file from which the 
data will be read. Enter the filename with any necessary qualifiers (such 
as drive letter or path names). If <ENTER> is pressed without entering 
any filename, the program will end the copy operation. After the output 
filename has been entered, the program will begin the copy operation. 
As sectors are written to the 8” diskette from the DOS file, a “writing” 
message will be displayed and updated to indicate that the copy is in 
progress. On completion of the copy operation, a message will be 
displayed indicating the total number of records (sectors) written to the 
diskette. The user will then be prompted to enter a starting CCHSS 
number for another copy operation. 


The user will be prompted to enter a starting CCHSS number for another 
copy operation using the same DOS file: enter a new starting CCHSS or 
press <ENTER3 to exit the copy operation. 


The program will ask whether you want to copy from another file: enter 
<Y> to continue, or enter <N> or <ENTER> only to end the program. 


DEFAULTS: 

Device Type: <ENTER> means 8" diskette. 

Drive number: <ENTER> means drive 1 

Starting CCHSS: <ENTER> means exit CCHSS prompt. 
DOS File: <ENTER> means exit copy operation. 
ASCII to EBCDIC: <ENTER> means No. | 
Another Copy? <ENTER> means No. 


DESTRUCTIVE/NONDESTRUCTIVE: 


CPY5TO8 will not affect data in the DOS source file; however, ALL 
EXISTING DATA ON THE DESTINATION SECTORS OF THE 
EXTERNAL DISKETTE WILL BE DESTROYED BY THE COPY 
OPERATION. 
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SAMPLE RUN OF CPY5TO8: 


A>cpy5to8 <enter> 


COPY DOS FILE TO DISKETTE SECTORS PROGRAM 

COPYRIGHT FLAGSTAFF ENGINEERING 2/6/86 

THIS PROGRAM WILL COPY A DOS DATA FILE TO A SPECIFIED 
LOCATION ON A DISKETTE. THE USER CAN SPECIFY THE STARTING 
CYLINDER, HEAD, AND SECTOR FOR THE COPY. ASA USEROPTION, THE 
PROGRAM CAN TRANSLATE THE DATA FROM ASCII TO EBCDIC DURING 
THE COPY. THE PROGRAM WILL AUTOMATICALLY IDENTIFY THE DISK- 
ETTE FORMAT. | 


NORMAL CYLINDER VALUES (CC) ARE 00-79 FOR 8" AND 00-39 FORS5” 
NORMAL HEAD VALUES (H) ARE 0 OR 1 
NORMAL SECTOR VALUES (SS) FOR 8" ARE 

1-26 FOR 128-SD AND 256-DD 

1-15 FOR 256-SD AND 512-DD 

1-8 FOR 512-SD AND 1024-DD 

1-4 FOR 1024-SD AND 2048-DD 
NORMAL SECTOR VALUES (SS) FOR 5" ARE 

1-18 FOR 128-SD AND 256-DD 

1-9 FOR 256-SD AND 512-DD 

1-4 FOR 512-SD AND 1024-DD 

1-2 FOR 1024-SD AND 2048-DD 
ENTER DISKETTE TYPE (8°=DEFAULT/5=5",3=3 1/2°,Q=5"-QD,H=5"HD)? 
<enter> 
INSERT 8" DISKETTE - ENTER DRIVE (1/2-4) WHEN READY? <enter> 
DO YOU WANT ASCII TO EBCDIC CONVERSION (N/Y)? y 
ENTER STARTING CYLINDER, HEAD, AND SECTOR (CCHSS)? 01001 
DISKETTE IS 512 BYTE/SECTOR - DOUBLE DENSITY - DOUBLE SIDE 
ENTER SECTOR NUMBER ORIGIN (1=DEFAULT/0-1)? <enter> 
ENTER NUMBER OF SECTORS/TRACK (15=DEFAULT/4-32)? <enter> 
ENTER SECTOR GAP SIZE (027=DEFAULT/0-255)? <enter> 
ENTER DOS FILE NAME FOR COPY (AA\PATH\NAME.EXT)? 

\temp\8dump.asc 

WRITING CYL=01 HEAD=0 SECTOR=01 GOOD OPERATION 
WRITING CYL=01 HEAD=1 SECTOR=01 GOOD OPERATION 
WRITING CYL=02 HEAD=0 SECTOR=01 GOOD OPERATION 
WRITING CYL=02 HEAD=1 SECTOR=01 GOOD OPERATION 
WRITING CYL=03.HEAD=0 SECTOR=01 GOOD OPERATION 
WRITING CYL=03 HEAD=1 SECTOR=01 GOOD OPERATION 
WRITING CYL=04 HEAD=0 SECTOR=01 GOOD OPERATION 
END OF COPY - 0105 SECTORS WERE COPIED 
ENTER STARTING CYLINDER, HEAD, AND SECTOR (CCHSS)? <enter> 


DO YOU WANT TO COPY TO ANOTHER DISKETTE (N/Y)? <enter> 
A> 
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COPY8.COM 


USE: Duplicate an 8” diskette using a single 8" drive system. 


DESCRIPTION: COPY8.COM is designed to duplicate an 8" master 
diskette onto a blank 8" diskette using a single 8” drive system. 


The program will identify the format of the master 8" diskette. If the 
format cannotbe identified, the program will end the copy operation. The 
program can duplicate most 8" diskettes that are single or double sided, 
and single or double density with sector sizes of 128, 256, 512, 1024, or 
2048 bytes per sector. 


The program will duplicate the format and data of the master diskette 
onto a blank diskette. The program writes data to the blank diskette by 
formatting a sector, and then writing data to the sector. If asectorcannot 
be formatted on the blank diskette, an error message will be displayed 
and the program will end the copy operation. 


After data is written to the blank diskette, the program performs a write 
verify. Ifthe blank diskette cannot be write verified, an error message will 
be displayed and the program will end the copy operation. 


The program performs the copy operation by reading data from the 
master diskette and and then storing the data in memory. After the data 
has been read into memory, the master diskette must be removed from 
the drive and then the blank diskette must be inserted into the drive. The 
stored data will then be written to the blank diskette. A maximum of 256 
K bytes of machine memory is allocated for data aneee during the copy 
operation. 


RUNNING COPY8 

Run COPY8.COM by typing its name at the DOS system prompt. After 
displaying a program description message, the program will prompt the 
user to verify that the master diskette to be copied is in the 8" drive. 
Insert the master diskette into the drive and press <ENTER>. 

The program will then read data from the master diskette and store the 
data in available memory. The program will prompt the user to remove 


the master diskette and then insert the copy diskette into the drive and 
press <ENTER>. 
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Insert the blank diskette into the drive and press <ENTER>. The data 
stored in machine memory will be written onto the blank diskette. 


The program will prompt the user through the read-from-master, write- 
to-blank copy routine until the copy operation is completed. After the 
copy operation is complete, the program will ask whether the user wants 
to copy another diskette. Enter <Y> to copy another diskette, or enter 
<N> or the <ENTER> key only to end the program. 


DEFAULTS: 

Begin Copy: <ENTER> means begin. 
Continue Copy: <ENTER> means continue. 
Another Copy <ENTER> means No. 


DESTRUCTIVE/NONDESTRUCTIVE: 


COPY8.COM willnot destroy any data onthe master diskette; however, 
ALL DATA ON THE DISKETTE BEING COPIED 7O WILL BE 
DESTROYED. 


SAMPLE RUN OF COPY8: 


A>copy8 <enter> 


DUPLICATE 8" DISKETTE PROGRAM 
COPYRIGHT (c) FLAGSTAFF ENGINEERING 10/08/84 


** MAKE SURE MASTER DISKETTE IS IN DRIVE 1 ** 
PRESS ENTER KEY TO START COPY <enter> 


READING 8° 128-SD CYL=00 HEAD=1 

SECTOR=01 TRACK NOT FOUND 

DISKETTE IS 128 BYTE SECTOR - 

SINGLE DENSITY.- SINGLE SIDE 

READING 8° 128-SD CYL=XX HEAD=X 

SECTOR=XX GOOD OPERATION 

VERIFY 8° 128-SD CYL=XX HEAD=X 

SECTOR=XX GOOD OPERATION 

INSERT BLANK DISKETTE, PRESS ANY KEY... <enter> 


READING 8" 128-SD CYL=XX HEAD=X 
SECTOR=XX GOOD OPERATION 
VERIFY 8" 128-SD CYL=XX HEAD=X 
SECTOR=XX GOOD OPERATION 


INSERT MASTER DISKETTE, PRESS ANY KEY ... <enter> 
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READING 8" 128-SD CYL=XX HEAD=X 
SECTOR=XX GOOD OPERATION 
VERIFY 8" 128-SD CYL=XX HEAD=X 
SECTOR=XX GOOD OPERATION 


DISKETTE COPY IS COMPLETED - 
00 SECTORS OR TRACKS WERE SKIPPED 


DO YOU WANT TO COPY ANOTHER DISKETTE (N/Y)? <enter> 
A> 


EDIT8.EXE 


The EDIT8 program allows you to display and modify data on any 
specified sector of a diskette. This utility is useful for inspecting diskette 
files, for. discovering how a diskette is formatted, and for “patching” 
changes onto a diskette, as long as you know what sectors you need to 
modify. 


If records in a DOS tile need to be edited, the DOS utility DFILE included 
with this package should be used instead; see Section 5. 


EDIT8 can be used with any of the diskette typesdescribed in Table 1. 
Regardless of the diskette, data is displayed in screens of at most 256 
bytes of data. When updating data, the entire sector is rewritten to 
diskette. As with the 8" to 5" copy programs, sectors are selected by 
giving a 5-digit CCHSS number, where: 


CC is a two-digit cylinder number, 
H is the head number (0 or 1), and 
SS is a two-digit sector number. 


When in Display mode, the screen can be scrolled up or down, and the 
next or previous sector selected for display. When editing a sector, the 
cursor can be moved around on the screen as with a full-screen text 
editor. Data can be displayed and entered as either ASCII or EBCDIC, 
depending on a user-set toggle. 
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RUNNING EDIT8 


Run EDIT8 by typing its name at the DOS command prompt. After 
displaying an introductory message, you will be asked to insert the 
diskette to display and enter the number of the external drive it is in. 
(Table 2 gives these numbers.) Note that this must be an external drive, 
not one of the internal (built-in) drives. 


After the drive has been selected, the program will prompt you to give the 
diskette type (as in Table 1) and the starting sector number (CCHSS) to 
display. At any point while running EDITS8, pressing <ENTER> only atthe 
CCHSS prompt will allow you to end the program. If the CCHSS number 
given cannot be read, the following message will appear and you will be 
asked if you want to display another diskette (pressing <ENTER> only 
at this point will end the program): 


PERMANENT READ ERROR ON DISKETTE 


When these first 3 prompts have been answered, Display mode will be 
entered with the first 256 bytes of the selected sector displayed. Screen 
1 below shows an example of a display screen. The first column, “DISP,” 
gives the displacement (location) of each line of data in decimal: this is 
the number of bytes from the beginning of the sector, starting at zero. 
The center and right sections of the display give the hexadecimal and 
character values of the sector bytes, shown in lines of 16 bytes. The 
<F1>key toggles the display between the ASCII and EBCDIC character 
sets. Any non-printable characters are shown as_ periods in the 
character display area. 


When data is being displayed or edited, the bottom line on the screen 
shows the current CCHSS number, the sector length in bytes, whether 
the disk is single or double density (SD or DD), and how many sectors 
there are per track (shown as a range—"Sector xx to xx”). Note that a 
single diskette can have several different track formats (in terms of 
bytes-per-sector) on it; while the diskette format may vary from track to 
track, each sector on a track is generally identically sized. To move the 
display, the following keys can be used: 


<PgDn> display the next 256 bytes in sector 
<PgUp> display previous 256 bytes in sector 
<UpArrow> scroll display down one line 
<DnArrow> scroll display up one line 

<Home> display previous sector 

<End> display next sector 

<ESC> exit display screen 

<Fi> toggle between ASCII and EBCDIC 
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To “jump” to a new sector on the diskette, just type the new CCHSS 
number and press <ENTERs. If the specified sector cannot be found or 
read, amessage will so inform you, and you can enter a different number 
or exit the display. 


EDITING SECTOR DATA 


To enter Edit mode from the Display screen, use the <F9> key. The 
displayed data will remain in place, and the cursor will jump to the first 
byte in the hexadecimal display field. Any data entered now will be 
retained in memory until you exit from Edit mode. You can enter bytes 
either as hexadecimal values in the center section, or as ASCII or 
EBCDIC characters in the right section (depending on the setting of the 
display toggle which appears at the top of the section). To move the 
cursor from the hex entry to the character entry area or vice versa, use 
the <TAB> key. 


When new data has been entered, it must explicitly be written by the user 
back to diskette by using the <F9> key. This will write the data to the 
diskette sector, then exit the Edit screen. If you want to write the modified 
sector as a “deleted sector,” use <ALT> <D> instead to write and exit. If 
you decide you don't want the modified data written after all, the <ESC> 
key will exit without writing anything to diskette. 


Screen 2 in the sample run below shows an example of an Edit mode 
screen. 


DESTRUCTIVE/NONDESTRUCTIVE: 


If Edit mode is entered and sector data is changed and written back to 
the diskette, the data in that sector will be permanently changed. If no 
data is written back to diskette, EDITS will not alter any of the diskette 
data. 


SAMPLE RUN OF EDIT8 


C>edit8 
Diskette Data Display and Edit 
Copyright (c) Flagstaff Engineering 07/08/86 


This program displays selected data sectors froma diskette, allowing the user to 
edit the data (change any bytes in the sector), then write the updated sector back 
to thediskette. The datais displayedinhex along with either the ASCIl or EBCDIC 
interpretation. The currently displayed Cylinder, Head, and Sector (CCHSS) is 
shown at the bottom ofthe screen along with the sector size, the high and low 
sector ID on the track, and whether the diskette is single or double density(SD/ 
DD). 
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The following keys are usable from the display screen: 


<PgDn> Display the next 256 bytes in a sector 
<PgUp> Display the previous 256 bytes in a sector 
<UpArr> Scroll display down one line 
<DnArr> Scroll display up one line | 
<Home> Display previous sector is 
<End> _ Display next sector 
<Esc> Exit display : 
<F1> Toggle between ASCII/EBCDIC character display 
<F9> Enter Edit mode to change the currently displayed sector 

Fill in CCHSS & press <ENTER> to select a new sector fordisplay 


Insert diskette - enter drive number (1/1-4): <ENTER> 
Enter diskette type (8"=default/5=5",3=3 1/2",Q=5"-QD,H=5"-HD): <ENTER> 
Enter starting cylinder, head, sector (CCHSS): 00008 


Screen 1 (Display mode): 


[DISP =~ HEX DATA EBCDIC 


0 C8 C4 D9 F1 40 E3 40 40 40 40 40 40 40404040 = JHDR1 T | 
16 40 40 40 40 40 40 40 FOF2F5FED9FOF1FOFO | 0256R0100] 
32 F1F1FOF1F1FOFS5 404040 40C9404040F8 {1101105 | 8 
48 F6 FO F6 Fi F1FOFOF8 FO 40FOFOFOFO 4040 = |606110080 00 | 
64 40 40 40 40 40 40 40 40 40 40 FO F1 Fi FO F6 40 | 01106 | 
80 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 C9 | i 
96 C2 D4E2E8E2E3 C5 D4 F3 F6 40 4040 F1 4040 =|BMSYSTEM31| 
112 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 | | 


<Esc>- Exit display 
<F1> - Toggle between ASCII/EBCDIC character display 
<F9> - Enter Edit mode to change the currently displayed sector 
- Fillin CCHSS & press <ENTER> to select new sector for display 


CCHSS: CCHSS=00008 128 Bytes/Sector (SD) Sectors 01 to 26 
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Screen 2 (Edit mode): 


DISP HEX DATA EBCDIC 


O 40 40 82 93 81 95 92 F8 FO AD F7 F9 5A 40 7E 40 |blank80[79! =| 
16 FO 5E 40 40 40 40 40 40 40 40 40 40 40 40 40 40/0; 
32 40 40 40 40 40 40 40 40 40 40 40 4040 404040 | 
48 40 40 40 40 40 40 40 40 40 40 40 4040 40 4040 | 
64 40 40 40 40 40 40 40 40 40 40 40 40 40 40 4040 ‘*! 
80 40 40 40 40 40 40 40 40 40 40 40 404040 4040 | 
| 
| 


| 
| 
| 
| 
96 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 | 
112 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 | 
128 40 40 82 93 81 95 92 F3 F2 AD F3 F1 5A 40 7E 40 |blank32[31!=| 
144 FO 5E 40 40 40 40 40 40 40 40 40 40 40 40 40 40 JO; | 
160 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 | | 
176 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 ‘| | 
192 40 40 40 40 40 40 40 40 40 40 40 40 40 404040 | | 
208 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 | | 
224 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 ‘| | 
240 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 40 | | 


<Esc> - Quit edit without updating the diskette 

<F9> - Quit edit and write updated sector to diskette 

<ALT><D> - Quit edit and write updated sector as a deleted sector 
<TAB> - Toggle the cursor between hex and character entry areas 


CCHSS: CCHSS=04013 256 Bytes/Sector (DD) Sectors 01 to 26 
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DOSFMT8.EXE 


DOSFMT8 will format a DOS diskette in an external drive connected to 
the Flagstaff Engineering diskette controller card. We recommend th I 
you use only high-quality diskettes to avoid data errors and losses. ‘ 


DOSFMT8 can create nearly any DOS format desired using 8", 5 1/4”, 
and 3 1/2" diskettes. The program initializes the DOS FAT tables and 
directory based on values given by the user. 


This program contains a table of diskette formats which are installed 

using FMT8INS. As assembled, there are NO entries in the table. Each 

entry in the table has a name of from 1 to 20 characters. The format for 

executing this program is as follows: | 3 
DOSFMTS8 [/D:d] [T:type] or [/N:n] 


d = External drive number from 1 to 4. If not given here, 
it will be asked for by the program. 


type = The name of one of the types defined in the format table. 


n = The number of one of the types defined in the format table 


If neither /T or /N are given (or are invalid), then the program 
will display a list of all entries in the table. 


The operator may then choose a format by number. A list of the detailed 
parameters for that format will then be displayed and the operator may 
change one or more entries. Press <ENTER:> to start formatting. 


If a valid /T or /N are entered, the program displays the detailed paramter 
list and begins to immediately format the disk. The <ESC> key may be 
pressed to abort a format that has started. 


FMT8INS - Install the format table in DOSFMT8 


Run this program to install diskette formats into DOSFMT8.EXE. The 
names assigned to the formats with this program must be known to the 
operator fo DOSFMT8 to select the correct format. Names may contain 
blanks, but short concise names are better for executing DOSFMT8 fror” 
the command line. 


DOSFMTS is supplied with the following predefined formats installed: 
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Name Format 


IBM8LG 8" single sided, single density 
IBM8SM 8" double sided, double density 
IBMHD 5 1/4" 96 TPI, 1.2 meg, high density 
IBM360 5 1/4" 48 TP, 360k 

IBM3 3 1/2", 720k 

IBMQUAD 5 1/4" 96 TPI, 720k, quad density 


Using FMTS8INS to install table entries in 
device driver DOSFMT8 


This installs actual table entries into DOSFMTB8, so the user should 
preserve a copy of DOSFMT8.EXE before running this program. 


a. Name of entry. This is used on the command line in 
CONFIG.SYS to specify the type of drive/format attached to an 
external DOS diskette drive. 


b. The type of physical drive. 
8 = 8" drive 
S = 5 1/4" single/double denisty (48 tracks/inch) 
3 = 3 1/2" 720k | | 
H = 5 1/4" high density (96 tracks/inch, 1.2 meg) 
Q = 5 1/4" quad density (96 tracks/inch, 720k) 


To generate an entry which will access any DOS format found on adrive 
at execution time, enter ONLY the above two fields. To fully specify the 
format for faster diskette access or for formats which do not have a valid 
boot sector, also enter ALL of the following fields. 


Cc. System name. An eight character name placed in the boot 
sector. 

d. Sector size. Must be 128/256/512/1024 bytes. 

e. Sectors/allocation unit. The number of sectors allocated by 


each FAT table entry. 


f. Reserved sectors. The number of sectors preceeding the 
Start of the first FAT table, which is usually one (the boot 
sector). 

g. Number of FATS. The number of times the FAT table is 


repeated on the diskette, which is normally two times. 
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h. Directory entries. This determines the number of sectors 
allocated for the directory. 


i. Media descriptor. This is a hex value. | See DOS documen- 
tation for the usual values. This is largely ignored by DOS, 
except that the F9 value may cause problems if improperly 
used. 


j. Sectors/FAT. The number of sectors occupied by one FAT 
table. This is determined by the sectors/allocation unit and the 
total sectors in the media. 


kK. Sides. This must be 1 forsingle, or 2 for double sided diskettes. 
I. Sector origin. This must be 0 or 1. 
m. Density. Must be 'S' for single or 'D' for double density. 


n. Number of cylinders. 


FLAGSTAFF ENGINEERING 
DOS Diskette format program 


Number Type Name Number Type Name 


01 L8 
02 $8 
03 HIDEN 
04 SINCH 


Sample screen: DOSFMTS (first screen) 
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Sample run: 


C>FMTS8INS 
Enter format program name to install: DOSFMT8.EXE 


FLAGSTAFF ENGINEERING 
DOS Diskette Paramters 


ali 


Format name L8 
Device type (8/5/3/H/Q) 8 
System name FLAGFMT 
Sector size 512 
Sectors/alloc unit 1 
Reserved sectors 1 
Number of FATS 2 
Directory entries 224 
Media descriptor FE 
Sectors perFAT 7 
Sides 2 
Sector origin (0/1) 1 
Density (S/D) D 
Number of cylinders 77 
<I> 


oa 


Cc 
d 
e 
f 
g 
h 
j 
J 
k 
| 
m 


a 


Reply 


Sample screen: FMTSINS installation (second screen) 


DESTRUCTIVE/NONDESTRUCTIVE: 


DOSFMT8 WILL DESTROY ALL DATA ON THE DISKETTE BEING 
FORMATTED. 
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When an entry has been entered/modified, press <ENTER> to update 
that table entry. Page up and down may be used to browse through the 
table entries. Any entry which is displayed may be altered and then 
updated by pressing <ENTER>. Press <END> to actually install the 
modified entires into the device driver. You may press <ESC> at any 
time to abort without updating. Note: actual updating does not occur, 
unless and until the <END> key is pressed. 


Using the DOS format command 


Once the format of a diskette on a drive (letter) is known by the DOS 
operating system, the DOS FORMAT command may be used to format 
diskettes on that drive. If all parameters are given at install time, the 
format is always known. Ifthe parameters are being installed in from the 
boot sector, then at least one diskette of the desired format must have 
been accessed since the system has been booted. 


Sector sizes larger than 512 


DOS diskettes with a sector size of 1024 may be accessed. The device 
driver FLAGX.SYS tells DOS that the sector size is 512, but this is 
transparent to the user. 


Disk access speed 


lf only one known format of diskette is going to be used in a given drive, 
it may be advisable to specify all the parameters when installing it in 
FLAG.SYS. This allows the diskette to be accessed faster since the boot 
sector does not need to be reread each time media change is possible. 
Since there is no physical diskette change line supported on the external 
drives, the media is assumed to be questionable if no accesses have 
occurred within the last five (5) seconds. 


NOTE: for use oncolor displays, DOSFMT8, FLAGINS, and FMT8INS 
are all color installable using INSUTIL. 
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DOS FILE DISPLAY 
AND EDITING UTILITIES 


The Utility/8 package includes DOS utility programs for use in displaying 
and editing DOS files, especially those that have been transferred from 
8" diskettes. These programs are useful for inspecting such files after 
transfer to confirm the integrity of their contents, to break up large files 
into smaller pieces, and to do patching (editing) of data. 


The DOS file utility programs are: 


DCOPY.EXE Generates smaller multiple files 
from a large DOS file. 


DFILE.EXE Displays records, searches for data 
and patches records in a DOS file. 
DCOPY.EXE 


DCOPY will copy part of an existing DOS file to a separate file, or copy 
a large DOS file into several smaller files. The program allows a large 
DOS file to be copied to multiple 5-1/4" diskettes when the original file 
size exceeds the capacity of a single 5-1/4" diskette. Large files may also 
be split up to allow transfer of file segments to 8" diskettes. 


Files may be copied to and from any DOS file. The record length may 


be set by the operator to any logical record length required. Any number 
of records may be copied to the target file. 
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DCOPY.EXE 


DCOPY will copy part of an existing DOS file to a seperate file, or copy 
a large DOS file into several smaller files. The program allows a large 
DOS file to be copied to multiple 5-1/4" diskettes when the original file 
size exceeds the capacity of a single 5-1/4" diskette. Large files may also 
be split up to allow transfer of file segments to 8” diskettes. 


Files may be copied to and from any DOS file. The record length may 
be set by the operator to any logical record length required. Any number 
of records may be copied to the target file. 


RUNNING DCOPY 


Run DCOPY by typing its name at the DOS command prompt. After 
displaying a program description message, the program willthen prompt 
the user to enter the name of aDOS file to copy from: enter the file name 
using standard DOS syntax, including any necessary specifiers such as 
drive or path names. 


The program will then promptthe user for a logical record size. This can 
be any number that does not exceed the total number of characters in 
the file. Enterthe record size, or select variable-size records by pressing 
<ENTER:> only. : 


The program will then prompt the user to enter a target DOS file name 
to copy to: enter the file name using standard DOS syntax. 


The program will prompt the user for the number of records to be 
transferred. 7 


Press the <ENTER> key to copy all records in the file, or enter the 
number of records to copy. The program will copy the indicated number 
of records into the target file, and then display the number of records 
transferred. 


The user will be prompted to insert a new diskette or choose a fixed 
(hard) disk. 
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lf copying to a 5-1/4" diskette, place the next diskette in the drive and 
press the <ENTER> key. If copying to files on hard disk, press the 
<ENTER> key only to continue. 


The program will then prompt the user to enter a new target DOS file 
name to copy to. 


Enter the new file name using standard DOS syntax, or select the 
previously entered output file name by pressing the <ENTER> key only. 


The program will prompt the user for the number of records to be 
transferred. 


Press the <ENTER> key to copy all records in the file, or enter the 
number of records to copy. 


The program will copy the indicated number of records into the targetfile, 
- and then display the number of records transferred. Ifthe complete input 
file has been transferred, a message will be displayed indicating the total 
number of records copied from the input file to the multiple output files. 


The user willbe prompted to insert a new disk if the target disk becomes 
full and the copy operation is not complete. 


When the copy operation is complete, the user will be prompted to enter 


a new input file name. Enter a new DOS file name, or press <ENTER> 
only to end the program. 
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SAMPLE RUN OF DCOPY: 


C>dcopy <enter> 


THIS PROGRAM WILL COPY A SINGLE INPUT DOS FILE INTO MULTIPLE Ses 
OUTPUT FILES. 


ENTER INPUT FILE NAME: c:test 
ENTER RECORD LENGTH (CR=VARIABLE): <enter> 


ENTER OUTPUT FILE NAME (CR=SAME AS PREVIOUS OUTPUT): 
<a:test1.doc> 


ENTER RECORDS TO TRANSFER (CR=ALL): <100> 


00100 RECORDS COPIED TO OUTPUT FILE. 
OUTPUT FILE COMPLETE. MOUNT NEW VOLUME, PRESS ANY KEV... 
<enter> 


ENTER OUTPUT FILE NAME (CR=SAME AS PREVIOUS OUTPUT): 
<a:test2.doc> 


ENTER RECORDS TO TRANSFER (CR=ALL): <enter> 


00200 RECORDS COPIED TO OUTPUT FILE. 
COPY COMPLETE 00300 TOTAL RECORDS COPIED. 


ENTER INPUT FILE NAME: <enter> 


C> 


Utility/8 DOS File Utilities 5-4 


DFILE.COM 


DFILE is used to display, edit and search for datain DOS files. A file may 
be displayed using any logical record size desired by the user. Records 
are displayed as hexadecimal values with both EBCDIC and ASCII 
translations displayed for each value. Records may be edited (patched) 
as ASCII or EBCDIC characters or as hexadecimal byte values. 


When the program is loaded, a ‘>’ prompt will appear onthe screen. The 
program uses the following commands (items in CAPS are keyword 
entries that must be given; lowercase items are user-supplied entries). 
For the search commands, the search data must start one space after 
the command keyword. 


<ENTER> Display starting at next record until end of file is hit. 

nnnn Display record number nnnn. 

SA aaaaaa Search for ASCII string “aaaaaa” (no quotes 
needed). 

SE eeeeeee Search for EBCDIC string “eeeeee” (no quotes 
needed). 

SX XX XX XX Search for hexadecimal string "xx xx xx". 


PA rrrr 0000 Patch data in record number “rrrr” at offset “oooo” 
(both numbers are given as decimal numbers). 
See below for an explanation of the patching process. 


Cc Cancel display. Use to select another file or to write 
patched data to disk. 
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SEARCHING FOR DATA WITH DFILE 


The operation of allthe search commands aboveis similar, except forthe 
type of data being searched for. For the string (ASCII/EBCDIC) 
searches, DFILE takes any characters entered one space after the 
command (SA or SE) as the text to search for. Since no delimiters are 
required here, any characters including single and double quotes canbe 
searched for. 


After the search command is given, you will be asked for the record 
number with which to start the search. Enter the record number (in 
decimal), or press <ENTER> only to start the search at the top of the file. 


lf any matches are found, the record number and offset of the match will 
displayed. The program will then ask you if you want to continue the 
search. At this point, typing <Y> only will continue the search (DFILE 
doesn’t wait for you to hit <ENTER> here); any other key will end the 
search and re-display the command prompt “>”. 


PATCHING RECORDS WITH DFILE 


When the PA command is given, a prompt appears showing the record 
number, offset from the start of the record, and the first byte at that offset 
given in hexadecimal, ASCII and EBCDIC. The prompt looks like this: 


0048 39 9/.: 


meaning that at offset 48 (decimal) in the requested record, the first byte 
is ahex 39: the values separated by the slash are the ASCll and EBCDIC 
characters, respectively (a period indicates that the character is non- 
displayable in that character set). When the patch prompt appears, you 
can either type in new data to replace data in the record, or press 
<ENTER?> only to end the patch process. Patch data can be entered as 
ASCIl or EBCDIC strings or as a series of pairs of hexadecimal digits. 
ASCII strings are indicated by using apostrophes (“single quotes”) 
around the string, while EBCDIC strings are enclosed by double quotes. 
Hexadecimal data must be entered as 2 digits per byte, each pair 
separated by one space. 


When patching records, any changes entered are kept in machine 
memory only until the session is ended with the “C” command, when the 
data will actually be written out to disk. Any data entered will be written 
even if you exit the program using <CTRL> <BREAK> (not recom- 
mended). If no patches are made, nothing will be written out to the file. 
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RUNNING DFILE 


Run DFILE by typing its name at the DOS command prompt. After 
displaying a program description message, the user will be prompted to 
enter thename of a DOS file to display. 


Enter the filename using standard DOS syntax, including any necessary 
drive and path name specifiers. 


The program will then prompt the user for logical record size. This can 
be any number that does not exceed the total number of characters in 
the file. Enter the record size, or select the default size of 16 bytes by 
pressing <ENTER> only. 


The program will display the command prompt “>” and wait for the user’s 
input. Press the <ENTER> key to begin displaying the file at record 
number 0 (the first record in the file), or enter any of the commands 
described above. 


lf a record number is entered, 128 bytes of data willbe displayed as lines 
of 16 bytes each. The data is displayed by record number and offset 
(distance) from byte zero of the record. The data is displayed as 
hexadecimal values, with an ASCII translation to the left of the display. 
Directly under the ASCII translation is an EBCDIC translation of the 
same data. 


Selected records may be displayed and patched, or the display session 


ended with the “C” command and another file selected (or the program 
ended). 
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SAMPLE RUN OF DFILE: 


C>dfile <enter> 


DUMP A DOS FILE AND TRANSLATE TO ASCII AND EBCDIC. 


FILE NAME TO DUMP: rftoasc.tbl <enter> 


LOGICAL RECORD SIZE: <enter> 


FILE SIZE IS 00002 RECORDS PLUS 00000 BYTES LONG.> <enter> 


0000 0000 40 40 40 ........40 40 
0016 40 40 40 ........40 40 
0032 . 
011230 90 40 ........3D 22 

> <0001> <enter> 

0001 00003061 62.........40 Ft 
0016 F2 GA 6B........92 24 
0032 . 
0112 30 31 32........40 40 


> <PA 0001 02> <enter> 


0002 62 b/.: <‘this’> <enter> 


0112 30 90 40 ........3D 22 

> <0001> <enter> 

0001 0000 3061 62........40 F1 
0016 F2 6A 6B........92 24 
0032 . 
0112 30 31 32.........40 40 
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> <PA 0001 02> <enter> 


0002 62 b/.: <'this’> <enter> | 


0112 309040... 

> <0001> <enter> 

0001 0000 306162........ 
0016 F2 6A 6B........ 
0032 
01123031 32...... 


> <PA 0001 02> <enter> 


0002 62 b/.: <'this’> <enter> 
C> 
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APPENDIX A: DEVICE DRIVER 
SUPPLEMENTAL INFORMATION 


This section supplements the section on using the Flagstaff Engineer- 
ing device drivers; it is intended for use by those with special system 
configuration problems or by programmers using the Flagstaff Engi- 
neering disk/tape drives and controller cards. The device driver 
(FLAGIO.SYS) parameters are covered in detail. The secondary device 
driver, FLAGIOX.SYS, is covered in the device driver section of this 
manual. 


DEVICE DRIVER PARAMETERS 


The general form of the device driver statement for FLAGIO.SYS is: 


(1) DEVICE=FLAGIO.SYS [ (dev=c,i,a) ] 
[ (dev=c,i,a) ] 


where: 
- dev either “T” for a tape controller or "D” for a disk controller 


-¢ the DMAchannel which the controller uses, a number from 1 
to 3. 


-i the IRQ (interrupt request) level the controller is uses: in 
practice, this is a number from 3 and 6. 


-a the port address of the card, given as 3 hexadecimal digits. 


Note that the square brackets are not included in the statement itself; 
they indicate that the enclosed items are optional. In this case, this 
means that the device driver can be installed with no parameters at all, 
in which case the default values are used (see below). One or two sets 
of parameters can be given, in order to install the device driver for a disk 
or tape controller or both. 


Default values are: 
for tape controller card: 


dev=T, c=2, i=6, a=350 
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(the “i” parameter is ignored for tape, but must be included in the list) 
for disk controller card: 


dev=D, c=2, i=6, a=3E8 


CHANGING DEVICE PARAMETERS 


If there is any question of conflicts arising from the use of a Flagstaff 
Engineering disk or tape controller card in your system, read this section 
thoroughly to determine if you need to deviate from the default parame- 
ters given above. Otherwise, set up your system using the given 
defaults, then follow the procedures given in this manual and the 
installation guide to test the system. If there are problems, you may need 
to change parameters. If you’re not sure what you’re doing, our best 
advice is—GET HELP. Itis very easy to get into trouble here! If in doubt, 
call technical support at Flagstaff Engineering,(602) 774-5188, for 
assistance. 


WHAT THE DEVICE DRIVER PARAMETERS MEAN 


Channel is the number of the DMA (direct memory access) channets 
tobe used by the controller. Valid channel numbers are 1 through 3. 


IRQ ievel is athe hardware interrupt request level number to be used 
by the controller. Basicaily, this number is a priority number that the 
system hardware uses to determine which devices in the system take 
precedence when interrupts from these devices are serviced. Valid IRQ 
level numbers for the Flagstaff Engineering FLAGIO.SYS device driver 
are from 3 to 6. The following table shows the devices assigned tothese 
IRQ levels in the IBM PC/XT/AT: 


Table 8: IRQ level assignments 


IRQ level port/device assignment 

3 serial port 2 “COM2:” 

4 serial port 1 “COM1:” 

5 parallel port2 § 2nd printer 

6 diskette controller (internal drives) 


Source: /BM Technical Reference. 
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CHANGING THE DMA CHANNEL: 


DMA channel 2 is normally used by the Flagstaff Engineering tape and 
diskette controllers; this is the same channel used by the internal 
diskette controller. Usually the only time the DMA channel needs to be 
changed is when the system is acompatible non-IBM machine (“clone”), 
in which case DMA channel 1 should be used. 


The DMA channel specified on the device driver parameter line (1) 
above must match the channel selected on the controller card by 
changing jumpers. See the appropriate Installation Manual for instruc- 
tions on selecting the DMA channel option, and be sure to follow all 
precautions! NOTE: if your machine is an IBM-XT, DMA channel 3 is 
used by the fixed disk controller if present. In this case, only DMA 
channels 1 or 2 should be selected for use by the Flagstaff Engineering 
external controller card. 


CHANGING THE IRQ LEVEL 


If you change from DMA channel 2, you may need to change the IRQ 
level along with it: see the table below, for recommended settings. For 
the tape controller device driver, the IRQ level parameter is ignored 
(always set to 6). If you need to use a non-standard IRQ level because 
of system conficts, you need to know what IRQ levels are assigned tothe 
devices connected to your system: refer to Table 1, above. For example, 
_ if you have a 2nd printer on a parallel port, it uses IRQ 5 and makes this 
IRQ level unusable by other devices. COM1: and CON2: are normally 
used for asynchronous communications adapters (e.g., modems or net- 
working), but can also be reassigned (via the DOS MODE command) to 
drive a serial printer or other device. The point is that you need to select 
an IRQ level for the external drive (tape or disk) that will not conflict with 
existing devices on the system. 


CHANGING THE CONTROLLER PORT ADDRESS 


(For this section, some familiarity with computer hardware and terminol- 
ogy is assumed. If you are not knowledgable in this area, you'd be better 
off not poking around here without help!) 


The option of changing the base address of the controller card is 
provided as a way of resolving potential conflicts with other devices 
installed on the system. Both the tape and disk controller cards occupy 
8 consecutive port addresses, starting at the base address. By default, 
the controller cards use these port addresses (the first address is the 
base): ; 
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TAPE: 350 (hex) 
DISK: 3E8 “ 


The address of the diskette controller card is not currently selectable, but 
new releases of these cards will have this feature. 


As with the DMA channel (above), the port address given on the device 
driver command line (1) must match the address physically selected by 
jumpers on the controller card; see the Installation Manual for your 
external drive. In general, any address from 000 to hex 3F8 can be 
selected. In practice, most addresses are already reserved for other 
devices (both internal and external) and cannot be used. You should 
consult a system manual, such as the IBM Technical Reference, as well 
as documentation for any “add-ons” in your system, to find which 
addresses can be used. If in doubt, get help, or call technical support at 
Flagstaff Engineering. 
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APPENDIX B: USER-WRITTEN 
PROGRAM SUPPORT 


Advanced users of the Diskette Connection who need to design their 
own application programs will find two files of special interest on the 
distribution diskette. The files are DEMO.C and INT13C.ASM. 


DEMO.C is a short demonstration program written in Microsoft/Lattice 
‘C’. The program reads the first two tracks of an 8" diskette and stores 
the data in a DOS file. 


The program calls assembler routines from an object module named 
INT13C.OBJ. The source code is provided in INT13C.ASM. This 
module provides a user interface to external drives attached to the 
Flagstaff Engineering diskette controller card. 


DEMO.C must be compiled with your own C compiler and tested on your 
machine before linking INT13C.OBJ with your own programs. 


INT13C.ASM is a source file written in 8088 assembler language. This 
source file can be assembled into a linkable object module. Parameter 
passing structures will need to be modified to support calls from FOR- 
TRAN, BASIC, or other compilers that do not pass parameters in 
thesame manner as Microsoft/Lattice C. 


These programs are provided on an “as is” basis to be used as a starting 
point for user-designed custom applications. Modified versions of these 
modules will not be supported by Flagstaff Engineering. For those 
needing more information on parameter-passing specifications for vari- 
ous compilers, The Programmer's Guide To The IBM PC by Peter 
Norton, Microsoft Press, is recommended. 


DEMO.C 


DEMO.C is provided as a sample C program to access external drives 
through device drivers FLAGIO.SYS, and FLAGIOS.SYS. 


The following routines are defined in the program. All of these routines 
pass back an integer: return code of zero if successful and a-1 if 
unsuccessful, with the exception of the FIND8 routine which passes 
back the diskette format if it is found or a -1 if it is not found. 
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The following parameters are specified in the routine calls: 


drive: the external drive number (2 - 5). 

cylinder: the diskette (0-79) 

head: the diskette head (0 or 1). 

sector: the starting sector for the operation (1 to 26). 
#recs: number of sectors to read/write. 

buffer: the address of the buffer to read/write to/from. 
fmt: diskette format: 


O0= 128 byte single density, 8" drive. 

1 = 256 byte single density, 8” drive. 

2 = 512 byte single density, 8" drive. 

3 = 1024 byte single density, 8" drive. 

4= 256 byte double density, 8" drive. 

5 = 512 byte double density, 8" drive 

6 = 1024 byte double density, 8" drive. 

7 = 2048 byte double density, 8" drive. 

8 - 15 indicate same formats as 0 - 7 for 5 1/4” 

or 3 1/2" drives. 


Drive, cylinder, head, sector, #recs, and fmt are processed as byte 
values but may be defined as integers. Buffer is the address of the buffer 
for the read, write or set format operation. The following routine calls are 
included in this file: | 

A. rc = READS (drive,cylinder,head, sector,#recs, buffer); 

Read one or more sectors from the 8" diskette. 

B. rc = WRITES (drive,cylinder,head, sector,#recs,buffer); 

Write one or more sectors to the 8" diskette. 


C. re = VERIFY8 (drive,cylinder,head,sector,#recs, buffer); 


Read-verify one or more sectors. This is the same as read except the 
data is not actually transferred. 


D. rc = RDDELS (drive,cylinder,head, sector,#recs,buffer); 


Read deleted sectors. This is the same as READ8 except that deleted 
sectors are also read if encountered. 


E. rc = WRTDELS8 (drive,cylinder,head, sector,#recs, buffer); 


Write deleted sectors. This will write sectors out as deleted. 
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F. rc = FORMATS (drive,cylinder,head,sector, #recs, buffer); 


Format sectors. This command is normally issued for a complete track 
at atime. The ‘buffer’ parameter must point to a buffer formatted with 4 
bytes for each sector on the track. The 4-byte entry for each sector is 
defined as follows: 


0 - Cylinder number. 

1 - Head number. 

2 - Sector number (normally starts with sector 1 on a track). 
3 - Sector size (0 = 128, 1 = 256, 2 = 512, 3 = 1024, 4 = 2048). 


G. rc = RESETS (drive); 

This recalibrates the drive (seeks cylinder 0). 

H. rc = SETS (drive,fmt); or re = SETS (drive,8,buffer); 

This sets up the 8" drive logic to process the specified diskette format. 
This routine (or FIND8) MUST be used prior to using any of the functions 
to access the diskette. The ‘fmt’ parameter must be 0 to 15 as defined 
above; if user-specified format parameters are used, then the user must 
supply a 12-byte buffer containing the diskette setup parameters. 

|. rc = FINDS (drive,cylinder,head); 

This routine will determine the format of the diskette on the requested 


track (cylinder & head). If the format is found, a value of 0 to 7 will be 
returned. If the diskette is unreadable a value of -1 will be returned. 
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INT13C.ASM 


ASSEMBLY LANGUAGE INTERFACE TO INTERRUPT 13H 
ROM BIOS CALLS FOR FLAGIO.SYS DEVICE DRIVER 


REGISTER USAGE 


On entry to each function: 


Function number 

Number of sectors 
Address of buffer ES:BX) 
Cylinder number 

Sector number 

Head number (0 or 1) 
Drive number (2, 3, 4, or 5) 


On return from each function: 


Return status code: ST1 bits: 
operation was OK — 
bad address mark found 0 
disk write protected — 1 

sector not found 7 

deleted sector(s) found * see during 


read operation note 
DMA overrun (across 64K) 4 
bad CRC (data error) 5 


* NOTE: this status is returned only for a normal read operation 


(function 2) andco 


rresponds to ST2 bit 6. This status is never returned 


for function 6, Read Deleted Sectors. 


AL - num 


FUNCTIONS: 


ber of sectors 


AH =0 Reset drive 
AH = 1 Read status of last operation into AL 


AH=2 r 


ead sector(s) into memory 


AH =3 Write sector(s) from memory 

AH = 4 Verify sectors(s) 

AH = 5 Format track. Format values are in data pointed to by 
ES:BX, with four bytes for each sector on the track: 
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0 - Cylinder 

1 - Head 

2 - Record (sector) number 

3 - Sector size: — 

0=128, 1=256, 2=512, 3=1024, 4=2048 
AH =6 Read deleted sector(s) into memory. 

Except for hard errors, this function will always return a status 
code of 0. Therefore, function A should be called in order to 
check the 3 status bytes. 

AH = 7 Write deleted sector(s) from memory 
AH =8 Set format. The format code is contained in AL. Sector size 
and recording method for values of AL are: 
O- 128FM8" 5-512 MFM 8" 
1- 256FM8" 6- 1024 MFM 8" 
3-1024FM8" 7-2048 MFM 8" 
_ 4- 256 FM 8" 
8-15 - format same as 0-7 but for 5 1/4" 
16 - use user-supplied format parameters. 


Format parameter values are in 12 bytes pointed to by DS:SI. Default 
parameters for each value of AL are given in the following table: 


Table 9: Format Parameter Values 


offset 
ALO 1 2 3 4 5 6 7 8 9 10 11 


CF 02 7F 00 1A 07 80 1B F6 19 00 01 
CF O2 7F 01 OF OE FF 2A F6 19 00 01 


OON ON HB WND — © 
'@) 
“Tl 
ro) 
Nh 
NJ 
n 
© 
NO 
ro) 
Tl 
anh, 
w 
“T1 
“Tl 
ol 
rs 
ma 
ro») 
ow, 
Ce) 
ro) 
oO 
© 
© 


anh, 
— 
@) 
TI 
ro) 
Ne) 
~“ 
mT 
° 
GO 
fo) 
nr 
OQ 
co 
“Ti 
Tl 
“Ti 
mn 
m 
on 
coal, 
Ce) 
° 
° 
o) 
a) 
* s * * * * * * 


16: —user-supplied format parameters— 
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(* NOTE: lines 0-7 are parameters for 8"diskettes; lines 8-15 are for 
5-1/4" and 3-1/2" diskettes.) 


Table 10 has the diskette type description corresponding to lines 0-15 in 
this table. 


Following are the meanings of the format parameter bytes: 


offset meaning 


controller parm byte 1 

controller parm byte 2 

Motor turn off wait 

Sector size: 0=128, 1=256, 2=512, 3=1024, 4=2048 
Sectors per track 

- Gap length 

-DTL 

- Gap length 

- Format fill character 

- Head settle time (ms) 

- Motor wait 

- Bit O—recording method: 0 = MFM, 1 =FM 
Bit 1—diskette size: 0 = 8", 1 = 5-1/4" or 3-1/2" 


a eo ee ee ee 


-— © 


AH = 9: Read sector ID’s (on currently selected track) 

AH = A: Acquire results of read sector ID (function 9). This function can 
be called to check status of any previous operation. Returns 7 
bytes pointed to by DS:BX formatted as follows: 
+0 - SO (diskette status byte 0) 


41-S1 “% “ " 4 
42-S2 “% "% "2 
+3 - Cylinder 

+4 - Head 


+5 - Record (sector) number 
+6 - Sector size: 
0=128, 1=256, 2=512, 
3=1024, 4=2048 


The three status bytes, SO-S2, are actually set by the diskette controller 
chip, and contain status information not returned in the AH register. For 
a detailed description of thesebytes, including bit layout and meaning, 
see the documentation for either the Intel 8272 or the NEC 765 floppy 
disk controller (FDC). 
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Table 10: Diskette Format Types 


format # bytes/ recording 
(AL. Table 9) size sector method 
0 8" 128 FM 

1 8" 256 FM 

2 8" 512 FM 

3 8" 1024 FM 

4 8" 256 MFM 

5 8" 512 MFM 
6. 8" 1024 MFM 

7 8" 2048 MFM 

8 3°/5" 128 FM 

9 3°/5" 256 FM 

10 3°/5" 512 FM 

11 3°/5" 1024 FM 

12 3°/5" 256 MFM 
13 3°/5" 512 MFM 
14 3°/5" 1024 MFM 
15 3°/5" 2048 MFM 


For further information on the BIOS calls, register usage, etc., see the 
IBM PC Technical Reference Manual and the Intel or NEC documents- 
mentioned above (either one can be used to program the floppy disk 
controller). 


Utility/8 User-Written Support B-7 


TABLEDIT.COM 


Included with this Flagstaff Engineering software package is the pro- 
gram TABLEDIT which allows you to edit the translation table files used 
by other programs herein. These files contain 256-byte lookup tables 
which are used to translate characters between one character set and 
another (usually between ASCII and EBCDIC). TABLEDIT allows you 
to replace the characters at any position in the translation table file 
enabling you to create a customized table for your application. For 
instance, if you are copying files from one system in EBCDIC to DOS files 
in ASCII, but need to translate certain characters differently then the 
standard EBCDIC-to-ASCIl conversion, you can specify these charac- 
ters in a modified translation table file. 


HOW TRANSLATION TABLES WORK 


The translation table is a file which specifies a new value for each 
possible value of a character. Since each byte (character) can have any 
of 256 possible values, the table contains 256 entries. Each entry is 
simply a byte which contains the new value corresponding to that 
position in the table. When an incoming byte is found whose value 
corresponds tothe position inthe table, the byte aun position becomes 
the new value. 


For example, consider the following mini-table (assume a system where 
every character can have 10 possible values): the top row is the position 
in the table, the bottom row is the actual table. 


-0- -1- -2- -3- -4- -5- -6- -7- -8- -9- 
5678111948 


First of all, notice that the positions start from zero, not one. This is 
because the possible values of the bytes in this system go from zero to 
9, just as the values of bytes on acomputer system go from 0 to 255. So, 
we can talk about the “zeroth” to the “ninth” position. 


When bytes come in to be translated, their value becomes a position in 
the table—for example, the incoming byte ‘4’ would “point” to position 4: 


V 
-0- -1---2- -3- -4- -5- -6- -7- -8- -9- 
56781119483 
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The translation process simply takes the character at the position 
pointed to (4) and uses that character as the new value—in this case, ‘1’. 
Since there are is an entry in the table for each possible value of a 
character, all characters can be translated. 


Notice that this example table has some repeated characters. Not all 
characters in the table need to be unique. In fact, the standard translation 
tables internal to TABLEDIT contain many repeated characters: for 
instance the NUL character (the “zeroth” character in both ASCII and 
EBCDIC) is used to “fill” vacant positions in both the ASCII and EBCDIC 
tables that have no defined values. 


WHAT THE TABLE EDITOR DOES 


Changing a translation table consists of substituting new values at 
certain positions in the table file. This is a fairly simple process, since the 
files are always the same size—256 bytes—and this can be done with 
programs such as DEBUG and even by some text editors. TABLEDIT 
makes this job much easier, by displaying each entry in the table and 
allowing you to type in new values where wanted. Each value is 
displayed in 4 possible ways—numericallly in either decimal or hexa- 
decimal, and as characters (either visually as IBM display characters, or 
as a two-or three-letter mnemonic code for control characters). After all 
changes have been made, the modified file can be written back to 
diskette. You can also create new translation table files from scratch. 


RUNNING TABLEDIT 


Run the program by typing its name at the DOS command prompt, 
followed (optionally) by the name of the translation table file you want to 
edit. (If you omit the file name, you can specify the file later.) The one 
program display screen will appear. 
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Decimal FLAGSTAFF ENGINEERING Translation Table Editor ASCII—>EBCDIC 


Internal ASCII—>EBCDIC table loaded. 
Table file: 
From: To: From: To: From: To: From: To: 


0 NUL—> O NUL 
1SOH—> 1 SOH 
2 STX—> 2 STX 
3 ETX—> 3 ETX 
4EOT— 55 EOT 
§ ENQ—> 45ENQ 
6 ACK—> 46 ACK 
7 BEL—> 47 BEL 
8BS—> 22 BS 

1 9HT—> 5 HT 
10 LF —> 37 LF 
11 VT —> 11 VT 
12 FF —> 12 FF 
13 CR—> 13CR 
14 SO —> 14S0 
15 Si—> 


16 DLE—> 
17DCi—> + 170DC1 
18DC2—>. 18DC2 
19DC3—> 19DC3 
20DC4—>  60DC4 
21NAK—> 61NAK 
22SYN—>  50SYN 
23ETB—>: 38ETB 
24CAN—> 24CAN 
25 EM —> 25 EM 
26 SUB—> 63SUB 
27ESC—> 39ESC 
28 FS —> 34 FS 
29 GS —> 29 IGS 
30 RS —> 30 IRS 
31 US —> 


F1Help F2ASCIVEBCDIC F3Read F4Write F5Default F6Exit F7Dec/Hex F8ShowCharCodes 


This screen shows the first screen of the translation table. There are 4 
screens, each showing 64 characters. Each character is shown as an 


. 


entry as follows: 


nnn CCC —> nnn CCC 


The left side (“FROM”) is the table position, corresponding to the 
incoming characters to be translated. The right side (“TO”) is the new 
value to be used for this position. “nnn” is the numeric value (either 
decimal or hexadecimal, depending on the current setting which is 
shown at the upper right of the screen). “CCC” is the character, shown 
either as a single character or as a 2- or 3-letter mnemonic code for 
control characters. If a value is represented as such a mnemonic code, 
it will be highlighted on the screen to make it stand out. 


To replace a value at a certain table location, you simply type in the 
desired new value at that location. This can be done either by typing a 
new numeric value in the numeric field, or by typing any keyboard 
character in the character field. As new values are entered, all fields will 
be changed to reflect the new value. 


Utility/8 TABLEDIT.COM C-3 


To move from entry to entry and from numericto character fields, you use 
the following keys: 

<cursor right> - these move from entry to entry 

<cursor left> 

<cursor up> 

<cursor down> 


<TAB> - moves from numeric to character fields 

<SHIFT> <TAB> - moves backwards from numeric to 
character fields 

<PgUp> - displays previous screen 

<PgDn> - displays next screen 

<backspace> - deletes numbers entered in decimal mode; 


moves back to first digit in hex mode. 


In addition, the eight (8) function keys displayed at the bottom of the 
screen are programmed to perform the following jobs: 


<F1> - HELP 


_ This displays one screenful of help information. To return to editing, hit 
the <ESC> key. The editing screen is restored upon return. 


<F2> - ASCII/EBCDIC TOGGLE 


This toggles the display between ASCIl-to-EBCDIC and EBCDIC-to- 
ASCII display. The first character set is the "FROM” set, the second is 
the “TO” set. In the example screen shown, “FROM” is shown as ASCIl, 
“TO” as EBCDIC. 


This toggle also effects the “default” (internal) translation table which will 
be loaded by the <F5> key—see below for explanation. Changing this 
toggle does not change the value of any table entries, only their 
representation. 


<F3> - READ FILE . 


This key reads a translation table from disk into the editor’s workspace. 
The file currently named in the “Table file” field will be loaded. If this field 
is blank, you will be asked to enter a filename here. Any errors 
encountered while reading the file (such as file not found) will be reported 
on the status line (screen line 3). : 


When the file is loaded, TABLEDIT tries to determine what type of table 


it is and displays the type on the status line. See “How Table Type is 
Determined,” below. 
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Note that loading a table replaces whatever is in the editor's workspace. 
When editing more than one table, be sure to save a table before loading 
another. 


<F4> - WRITE FILE 


This key writes the translation table currently in memory to disk. The file 
‘currently named in the “Table file” field will be written. If this field is blank, 
you will be asked to enter a filename here. Any errors encountered while 
writing the file will be reported on the status line. 


Writing to a table file replaces whatever was originally in the file with the 
new table, so be careful when writing files. If you want to create a 
modified copy of a table file, you can change the name of the file before 
writing it. It is also a good idea to make backup.copies before editing, 
using the DOS “COPY” command. 


<F5> - LOAD DEFAULT TRANSLATION TABLE 


This replaces the entire translation table in editor memory with an 
internal “default” table, containing a standard translation sequence. 
(These standard sequences are taken from IBM's System/370 Refer- 
ence Summary, recognized as an industry standard reference.) This 
function is useful for building a translation table “from scratch,” where 
only a few characters need be changed. 


There are two internal tables—one for ASCII-to-EBCDIC, the other for 
EBCDIC-to-ASCIl. The current setting of the character-set toggle deter- 
mines which one will be loaded with <F5>. This toggle is shown at the 
upper right of the screen, and is set with the <F2> key (see above). 


Note that this function replaces whatever was in the editor workspace, 
so you should save any needed changes before loading the internal 
table. 


<F6> - EXIT 
This key ends the TABLEDIT program. Before exiting to DOS, you will 
be asked if you really want to leave, in case you forgot to save achanged 


table file. Answering ‘Y’ to this prompt will exit to DOS; any other key will 
continue the editing program. 
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<F7> - DECIMAL/HEX TOGGLE 


This key toggles the numeric field representation between decimal and 
hexadecimal. The current setting of this toggle is shown at the upper 
right of the screen. This mode affects the way numeric data is entered 
in entry fields. In decimal mode, there are 3 digit positions, and the 
<backspace> key removes the leftmost digit, or changes the value to 
Zero if there is only one digit in the field. Using the number keys will add 
one digit to the number, until 3 digits have been entered. In hexadecimal 
mode, two digits are always displayed. The cursor starts onthe left (high- 
order) digit, and entering adigit here will move the cursorto the right digit. 
The <backspace> key moves the cursor back to the left digit. 


Changing this toggle does not change the value of any table entries, only 
their representation. 


<F8> - TOGGLE “SHOW CHARACTER CODES” 


This toggle controls the representation of table entries in the character 
fields. With the toggle on, control characters (e.g., carriage return, line 
feed, tab, etc.) are shown as a2-or 3-character menmoniccode (CR, LF, 
TAB, etc.). With the toggle off, all characters are shown as IBM screen 
display characters. This character set doesn't correspond to any other 
character set in common use, since “high ASCII’ values above 127 
decimal are special characters peculiar to the IBM PC. 


The mnemonic codes displayed are taken from the IBM System/370 
Reference Summary, recognized as an industry standard reference. 
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